]]>
]]>
tt_default_session
library call
tt_default_session
retrieve the current default session identifier
#include <Tt/tt_c.h>
char *tt_default_session
DESCRIPTION
The
tt_default_session function
retrieves the current default session identifier.
RETURN VALUE
Upon successful completion, the
tt_default_session function returns the pointer to the unique identifier for the
current default session.
If the pointer is
NULL, no default session is set.
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_PROCID
The current default process identifier is out of date or invalid.
APPLICATION USAGE
A session can have more than one session identifier.
This means that the application
cannot compare the result of
tt_default_session with the result of
&cdeman.tt.message.session; to verify that the message was sent in the default session.
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;.