ttmedia_load_reply(3)

ttmedia_load_reply(3)  C LIBRARY 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 docu-
     ment.  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  docu-
     ment.

     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()  func-
     tion  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 mes-
		sage.

	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.

Unix System LaboratorLast change: 11 May 1994			1

ttmedia_load_reply(3)  C LIBRARY FUNCTIONS  ttmedia_load_reply(3)

SEE ALSO
     Tttttk(5),	ttmedia_load(3), ttmedia_ptype_declare(3),
     ttmedia_Deposit(3).

Unix System LaboratorLast change: 11 May 1994			2