ttmedia_load_reply - reply to a Display, Edit or Compose request
#include <Tt/tttk.h> Tt_message ttmedia_load_reply(Tt_message contract, const unsigned char *new_contents, int new_len, int reply_and_destroy);
ttmedia_load_reply(3) ToolTalk Functions ttmedia_load_reply(3) NAME ttmedia_load_reply - reply to a Display, Edit or Compose request SYNOPSIS #include <Tt/tttk.h> Tt_message ttmedia_load_reply(Tt_message contract, const unsigned char *new_contents, int new_len, int reply_and_destroy); DESCRIPTION The ttmedia_load_reply() function is used to reply to a Media Exchange request to display, edit or compose a document. The editor working on the request usually calls ttmedia_load_reply() when the user has indi- cated in some way that he or she is finished viewing or modifying the document. If new_contents and new_len are non-NULL and non-zero, respectively, ttmedia_load_reply() uses their values to set the new contents of the document back in the appropriate output argument of contract. If reply_and_destroy is True, ttmedia_load_reply() replies to contract and then destroys it. RETURN VALUE Upon successful completion, the ttmedia_load_reply() function returns the created Tt_message; 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_ERR_NOMP The ttsession(1) process is not running and the ToolTalk service cannot restart it. TT_ERR_NOTHANDLER This application is not the handler for this message. TT_ERR_NUM The integer value passed was invalid (out of range). TT_ERR_PROCID The specified process identifier is out of date or invalid. APPLICATION USAGE If contract is a Display request, then new_contents and new_len should be zero. ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+------------------+ |Availability | library/tooltalk | +---------------+------------------+ |Stability | Committed | +---------------+------------------+ SEE ALSO tttk(5), ttmedia_load(3), ttmedia_ptype_declare(3), ttmedia_Deposit(3). ToolTalk 1.3 1 March 1996 ttmedia_load_reply(3)