tt_message_context_xval(3)

tt_message_context_xvalC3LIBRARY FUNCTItt_message_context_xval(3)

NAME
     tt_message_context_xval - retrieve	and deserialize	the  data
     from a message's context

SYNOPSIS
     #include <Tt/tt_c.h>

     Tt_status tt_message_context_xval(Tt_message m,
				       const char *slotname,
				       xdrproc_t xdr_proc,
				       void **value);

DESCRIPTION
     The tt_message_context_xval() function retrieves and deseri-
     alizes the	data from a message's context.

     The m argument is the opaque handle for the message involved
     in	this operation.	 The slotname argument describes the con-
     text of this message.  The	xdr_proc argument points  to  the
     XDR  procedure to be used to deserialize the data in the nth
     argument into newly allocated storage, the	address	of  which
     will be stored in the pointer whose address is value.

     The value argument	is the data to be deserialized.

RETURN VALUE
     Upon successful  completion,  the	tt_message_context_xval()
     function  returns	the status of the operation as one of the
     following Tt_status values:

	TT_OK	The operation completed	successfully.

	TT_ERR_MODE
		The specified Tt_mode is invalid.

	TT_ERR_NOMP
		The ttsession(1) process is not	running	 and  the
		ToolTalk service cannot	restart	it.

	TT_ERR_POINTER
		The pointer passed does	not point to an	object of
		the correct type for this operation.

	TT_ERR_NUM
		The integer value  passed  was	invalid	 (out  of
		range).

	TT_ERR_XDR
		The XDR	procedure failed on the	 given	data,  or
		evaluated to a zero-length expression.

Unix System LaboratorLast change: 11 May 1994			1

tt_message_context_xvalC3LIBRARY FUNCTItt_message_context_xval(3)

APPLICATION USAGE
     The allocation calls are made by the XDR  procedure;  there-
     fore,  any	storage	allocated is not allocated from	the Tool-
     Talk allocation  stack.   The  application	 should	 use  the
     xdr_free(3) call to free this storage.

SEE ALSO
     Tttt_c(5);	the .

Unix System LaboratorLast change: 11 May 1994			2