tt_message_arg_xval(3)

tt_message_arg_xval(3) C LIBRARY FUNCTIONS tt_message_arg_xval(3)

NAME
     tt_message_arg_xval - retrieve and	deserialize the	data from
     a message argument

SYNOPSIS
     #include <Tt/tt_c.h>

     Tt_status tt_message_arg_xval(Tt_message m,
				   int n,
				   xdrproc_t xdr_proc,
				   void	**value);

DESCRIPTION
     The tt_message_arg_xval() function	retrieves  and	deserial-
     izes  the	data from a message argument.  This function uses
     an	XDR routine that is supplied by	the client.

     The m argument is the opaque handle for the message involved
     in	 this  operation.   The	 n  argument is	the number of the
     argument to be returned.  The  first  argument  is	 numbered
     zero.   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_arg_xval()  func-
     tion  returns the status of the operation as one of the fol-
     lowing 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 structure.

Unix System LaboratorLast change: 11 May 1994			1

tt_message_arg_xval(3) C LIBRARY FUNCTIONS tt_message_arg_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