ttmedia_load_reply(library call) ttmedia_load_reply(library call)
NAME [Toc] [Back]
ttmedia_load_reply - reply to a Display, Edit or Compose request
SYNOPSIS [Toc] [Back]
const unsigned char *new_contents,
DESCRIPTION [Toc] [Back]
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
indicated in some way that he or she is finished viewing or modifying
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 [Toc] [Back]
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:
The ttsession(1) process is not running and the ToolTalk
service cannot restart it.
This application is not the handler for this message.
The integer value passed was invalid (out of range).
The specified process identifier is out of date or invalid.
APPLICATION USAGE [Toc] [Back]
If contract is a Display request, then new_contents and new_len should
SEE ALSO [Toc] [Back]
Tt/tttk.h - Tttttk(5), ttmedia_load(3), ttmedia_ptype_declare(3),
- 1 - Formatted: January 24, 2005 [ Back ]