]]>
]]>
tt_thread_session
library call
tt_thread_session
retrieve the default session identifier for the currently active thread
#include <Tt/tt_c.h>
char *tt_thread_session
DESCRIPTION
The
tt_thread_session function
retrieves the default session
identifier for the currently active thread. If there is no default
session set for the currently-active thread, then the process default
session identifier is returned.
A session can have more than one session identifier.
This means, for example, that the application cannot compare the
result of tt_thread_session with the result of
tt_message_session to verify that the message was
sent in the default session.
The returned pointer points to the character string name of
the session. When no longer needed, it must be
freed with tt_free.
ARGUMENTS
None.
RETURN VALUE
Upon successful completion, the
tt_thread_session function returns
the pointer to a character string that uniquely identifies the default
session for the currently active thread.
TT_OK
The operation completed successfully.
TT_ERR_NOMP
The ttsession process is not running
and the ToolTalk service cannot start it.
TT_ERR_PROCID
The current default process identifier is out of date or invalid.
TT_ERR_UNIMP
The ToolTalk implementation does not support multithreading.
TT_ERR_TOOLATE
The multithreading feature has not been enabled.
APPLICATION USAGE
None.
SEE ALSO
&cdeman.Tt.tt.c.h;,
&cdeman.tt.free;,
&cdeman.tt.ptr.error;