Common Desktop Environment: ToolTalk Messaging Overview


Tt_pattern * ttdt_subcontract_manage( Tt_message 	contract,
  										Ttdt_contract_cb	      cb,
 										Widget                 shell,
  										void *                 clientdata

The ttdt_subcontract_manage() function manages an outstanding request. It allows the requesting tool to manage the standard Desktop interactions with the tool that is handling the request. This function registers in the default session for TT_HANDLER-addressed Get_Geometry and Get_XInfo requests, and Status notices.

If the shell parameter is null, the request or notice is passed to the cb parameter; otherwise, the request is handled transparently.

The ttdt_subcontract_manage() function returns a null-terminated array of Tt_pattern, which can be passed to the ttdt_session_quit() function to be destroyed. If an error occurs, the returned array that is an error pointer. Use tt_ptr_error to find the Tt_status. Table A-20 lists the possible errors returned.

Table A-20 Possible Errors Returned by the ttdt_subcontract_manage

Error Returned 



There is not enough memory available to perform the operation. 


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. 


The process identifier specified is out of date or invalid. 


The subcontract parameter was not a valid Tt_message.


Both the shell and cb parameters were null.