tt_message_arg_bval_set(3)

tt_message_arg_bval_setC3LIBRARY FUNCTItt_message_arg_bval_set(3)

NAME
     tt_message_arg_bval_set - set the byte-array value	and  type
     of	a message argument

SYNOPSIS
     #include <Tt/tt_c.h>

     Tt_status tt_message_arg_bval_set(Tt_message m,
				       int n,
				       const unsigned char *value,
				       int len);

DESCRIPTION
     The tt_message_arg_bval_set() function sets  the  byte-array
     value and the type	of the nth message argument.

     This function also	changes	the value of an	existing nth mes-
     sage argument to a	byte string.

     The m argument is the opaque handle for the message involved
     in	 this  operation.   The	 n  argument is	the number of the
     argument to set.  The first argument is numbered zero.   The
     value  argument is	the byte string	with the contents for the
     message argument.	The len	argument is  the  length  of  the
     value in bytes.

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

	TT_OK	The operation completed	successfully.

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

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

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

APPLICATION USAGE
     The sending process can  use  tt_message_arg_bval_set(3)  to
     fill in opaque data.

SEE ALSO
     Tttt_c(5),	tt_message_barg_add(3),
     tt_message_arg_val_set(3),	tt_message_arg_ival_set(3).

Unix System LaboratorLast change: 11 May 1994			1