]]>
]]>
tt_feature_required
library call
tt_feature_required
declare a feature to be required by the calling program.
#include <Tt/tt_c.h>
Tt_status tt_feature_required
Tt_feature feature
DESCRIPTION
The
tt_feature_required function
declares a feature to be required by the
calling code. If the feature is available,
tt_feature_required enables it.
If the feature requires the ToolTalk service to perform
some initialization (for example,
TT_FEATURE_MULTITHREADED),
the initialization is performed in this call. Some features
(such as TT_FEATURE_MULTITHREADED)
require this call to be made before calling
tt_open.
ARGUMENTS
feature
Specifies the feature to be required.
RETURN VALUE
Upon completion, the
tt_feature_required function returns
the status of the operation as one of the following
Tt_status values:
TT_OK
The feature is available and has been enabled.
TT_ERR_TOOLATE
The tt_feature_required call must be made
prior to other calls that have already been made to the ToolTalk API.
TT_ERR_UNIMP
The version of the ToolTalk library linked with the calling code does
not support the indicated feature.
APPLICATION USAGE
To use the ToolTalk library in a multithreaded environment, an
application would declare multithreading to be required before a call to
tt_open or ttdt_open:
Tt_status ttstat;
ttstat = tt_feature_required(TT_FEATURE_MULTITHREADED);
tt_open();
SEE ALSO
&cdeman.Tt.tt.c.h;,
&cdeman.tt.feature.enabled;,
&cdeman.tt.open;,
&cdeman.ttdt.open;