Common Desktop Environment: ToolTalk Messaging Overview

ttdt_session_quit

Tt_status    ttdt_session_quit(	const char *     sessid,
  								  Tt_pattern *     sess_pats,
  								  int              quit );

The ttdt_session_quit() function quits a ToolTalk session as a "good desktop citizen"; that is, it unregisters all the patterns and default callback it registered when it joined the session.

This function destroys all patterns in sess_pats. If the quit parameter is set, it quits the session sessid; if the sessid parameter is null, it quits the default session.

Table A-19 lists the errors that can be returned by this function.

Table A-19 Possible Errors Returned by the ttdt_session_quit

Error Returned 

Description 

TT_ERR_NOMP

The ttsession process is not available. The ToolTalk service tries to restart ttsession if it is not running. This error indicates that the ToolTalk service is either not installed or not installed correctly. 

TT_ERR_PROCID

The process identifier specified is out of date or invalid. 

TT_ERR_SESSION

An out-of-date or invalid ToolTalk session was specified. 

TT_ERR_POINTER

The pointer passed does not point at an object of the correct type for this operation. For example, the pointer may point to an integer when a character string is needed.