Index Click this button to go to the index for this section.


ttmedia_load_reply(3)

CDE

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 indicated 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_error3 to extract one of the following Tt_status values from the returned handle: The ttsession1 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

If contract is a Display request, then new_contents and new_len should be zero.

SEE ALSO

Tt/tttk.h5, ttmedia_load3, ttmedia_ptype_declare3, ttmedia_Deposit3.