]]>
]]>
tt_message_handler
library call
tt_message_handler
retrieve the handler attribute from a message
#include <Tt/tt_c.h>
char *tt_message_handler
Tt_message m
DESCRIPTION
The
tt_message_handler function
retrieves the handler attribute from the specified message.
The
m argument is the opaque handle for the message involved in this operation.
RETURN VALUE
Upon successful completion, the
tt_message_handler function returns the character value that uniquely identifies the
process that is to handle the message
(Tt_state =
TT_CREATED or
TT_SENT) or the process that
did handle the message
(Tt_state =
TT_SENT or
TT_HANDLED). The application can use
&cdeman.tt.ptr.error; to extract one of the following
Tt_status values from the returned pointer:
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;.