NAME tt_thread_session_set - set the default session identifier for the currently active thread SYNOPSIS #include <Tt/tt_c.h> Tt_status tt_thread_session_set ( const char *sessid ); DESCRIPTION The tt_thread_session_set() function sets the default ses- sion identifier for the currently active thread. The ToolTalk service uses the initial user session as the default session and supports one session per procid. The application can make this call before it calls tt_open(3) to specify the session to which it wants to connect in the active thread. The sessid argument is a pointer to the unique identifier for the session in which the procid is interested. RETURN VALUE Upon successful completion, the tt_thread_session_set() function returns the status of the operation as one of the following Tt_status values: TT_OK The operation completed successfully. TT_WRN_NOT_ENABLED The feature has not yet been enabled. TT_ERR_NOMP The ttsession(1) 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. TT_ERR_SESSION The specified ToolTalk session is out of date or invalid. APPLICATION USAGE To change to another opened session, the application must use either tt_thread_procid_set(3) or .BR tt_default_procid_set (3). To join other sessions, the procid must first set the new session as the default session, and then initialize and register with the ToolTalk service. The calls required must be in the following order: tt_thread_session_set() or tt_default_session_set(3) tt_open(3) The tt_open(3) may create another ToolTalk procid, the con- nection to which is identified by a procid. Only one Tool- Talk session per procid is allowed. (However, multiple pro- cids are allowed in a client.) There are no API calls to determine to which session a particular procid is connected. If it is important for the application to know the session to which it is connected. It must make the following calls in the indicated order: tt_open(3) tt_thread_session(3) The application can then store the information by indexing it by the procid returned by the tt_open(3) call. SEE ALSO tt_c(5), tt_open(3), tt_default_procid(3), tt_thread_procid(3), tt_default_session(3), tt_thread_session(3).
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |