ttdt_subcontract_manage

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	Description
TT_ERR_NOMEM	There is not enough memory available to perform the operation.
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_POINTER	The subcontract parameter was not a valid Tt_message.
TT_ERR_EINVAL	Both the shell and cb parameters were null.