[ новости /+++ | форум | теги | ]

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.

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
     tt_c(5).

Партнёры:

Хостинг: