tt_feature_required(library call) tt_feature_required(library call)
NAME [Toc] [Back]
tt_feature_required - declare a feature to be required by the calling
SYNOPSIS [Toc] [Back]
DESCRIPTION [Toc] [Back]
The tt_feature_required function declares a feature to be required by
the calling code. If the feature is available, tt_feature_required
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
ARGUMENTS [Toc] [Back]
feature Specifies the feature to be required.
RETURN VALUE [Toc] [Back]
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 [Toc] [Back]
The tt_feature_required call must be made prior to other
calls that have already been made to the ToolTalk API.
TT_ERR_UNIMP [Toc] [Back]
The version of the ToolTalk library linked with the calling
code does not support the indicated feature.
APPLICATION USAGE [Toc] [Back]
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:
ttstat = tt_feature_required(TT_FEATURE_MULTITHREADED);
SEE ALSO [Toc] [Back]
Tt/tt_c.h - Tttt_c(5), tt_feature_enabled(3), tt_open(3), ttdt_open(3)
- 1 - Formatted: January 24, 2005 [ Back ]