*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> tt_message_arg_xval (3)              


 tt_message_arg_xval(library call)         tt_message_arg_xval(library call)

 NAME    [Toc]    [Back]
      tt_message_arg_xval - retrieve and deserialize the data from a message

 SYNOPSIS    [Toc]    [Back]
      #include <Tt/tt_c.h>
      Tt_status tt_message_arg_xval(
      Tt_message m,
      int n,
      xdrproc_t xdr_proc,
      void **value);

 DESCRIPTION    [Toc]    [Back]
      The tt_message_arg_xval function retrieves and deserializes 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    [Toc]    [Back]
      Upon successful completion, the tt_message_arg_xval function returns
      the status of the operation as one of the following Tt_status values:

      TT_OK     The operation completed successfully.

                The specified Tt_mode is invalid.

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

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

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

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

                                    - 1 -       Formatted:  January 24, 2005

 tt_message_arg_xval(library call)         tt_message_arg_xval(library call)

 APPLICATION USAGE    [Toc]    [Back]
      The allocation calls are made by the XDR procedure; therefore, any
      storage allocated is not allocated from the ToolTalk allocation stack.
      The application should use the xdr_free(3) call to free this storage.

 SEE ALSO    [Toc]    [Back]
      Tt/tt_c.h - Tttt_c(5)

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
tt_message_context_xval HP-UX retrieve and deserialize the data from a message's context
tt_message_arg_type HP-UX retrieve the type of a message argument
tt_message_arg_ival HP-UX retrieve the integer value of a message argument
tt_message_arg_bval HP-UX retrieve the byte-array value of a message argument
tt_message_arg_xval_set HP-UX serialize and set data into an existing message argument
tt_message_arg_val_set HP-UX change the value of a message argument
tt_message_iarg_add HP-UX add a new argument to a message object
tt_message_arg_add HP-UX add a new argument to a message object
tt_message_arg_ival_set HP-UX add an integer value in a message argument
tt_message_xarg_add HP-UX add an argument with an XDR-interpreted value to a message object
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service