]]>
]]>
tt_message_pattern
library call
tt_message_pattern
return the pattern matched by a message
#include <Tt/tt_c.h>
Tt_pattern tt_message_pattern
Tt_message m
DESCRIPTION
The
tt_message_pattern function
returns the pattern that the specified message matched.
The
m argument is the opaque handle for the message involved in this operation.
RETURN VALUE
Upon successful completion, the
tt_message_pattern function returns the opaque handle for a message pattern.
The application can use
&cdeman.tt.ptr.error; to determine if the handle is valid.
The
tt_message_pattern function returns one of the following
Tt_status values:
TT_OK
The operation completed successfully.
TT_ERR_NOMP
The
&cdeman.ttsession; process is not running and the ToolTalk service cannot restart it.
TT_ERR_POINTER
The pointer passed does not point to an object of
the correct type for this operation.
APPLICATION USAGE
The application should use
&cdeman.tt.free; to free any data stored in the address returned by the
ToolTalk API.
SEE ALSO
&cdeman.Tt.tt.c.h;, &cdeman.tt.ptr.error;, &cdeman.tt.free;.