ttdt_subcontract_manage - manage an outstanding request
#include <Tt/tttk.h> Tt_pattern *ttdt_subcontract_manage(Tt_message subcontract, Ttdt_contract_cb cb, Widget shell, void *clientdata);
ToolTalk Functions ttdt_subcontract_manage(3)
NAME
ttdt_subcontract_manage - manage an outstanding request
SYNOPSIS
#include <Tt/tttk.h>
Tt_pattern *ttdt_subcontract_manage(Tt_message subcontract,
Ttdt_contract_cb cb,
Widget shell,
void *clientdata);
DESCRIPTION
The ttdt_subcontract_manage() function allows a requester to manage the
standard Desktop interactions with the tool that is handling the
request. The ttdt_subcontract_manage() function registers in the
default session for TT_HANDLER-addressed requests Get_Geometry and
Get_XInfo, and Status notices.
If shell is not NULL, the ToolTalk service handles the Get_Geometry and
Get_XInfo, and Status notices transparently; otherwise, it passes them
to cb.
See ttdt_session_join(3) for a description of a Ttdt_contract_cb call-
back.
If subcontract is destroyed by tttk_message_destroy(), then the pat-
terns will also be destroyed; otherwise, the caller is responsible for
iterating over the array and destroying each pattern.
RETURN VALUE
Upon successful completion, the ttdt_subcontract_manage() function
returns a null-terminated array of Tt_pattern, and associates this
array with subcontract; otherwise, it returns an error pointer. The
application can use tt_ptr_error(3) to extract one of the following
Tt_status values from the returned handle:
TT_DESKTOP_EINVAL
Both the shell and cb arguments were NULL.
TT_ERR_NOMEM
There is insufficient memory available to perform the func-
tion.
TT_ERR_NOMP
The ttsession(1) process is not running and the ToolTalk
service cannot restart it.
TT_ERR_POINTER
The subcontract argument was not a valid Tt_message.
TT_ERR_PROCID
The specified process identifier is out of date or invalid.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
SEE ALSO
tttk(5), ttdt_session_join(3), tttk_message_destroy(3).
ToolTalk 1.3 1 March 1996
ttdt_subcontract_manage(3)