Index for Section 3

Alphabetical listing for T

tt_message_arg_bval_set(3)
CDE


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 message 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: The
  operation completed successfully.
  The ttsession1 process is not running and the ToolTalk service cannot
  restart it.
  The integer value passed was invalid (out of range).
  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_set3 to fill in opaque
  data.

SEE ALSO
  Tt/tt_c.h5, tt_message_barg_add3, tt_message_arg_val_set3,
  tt_message_arg_ival_set3.