NAME

   rpc_mgmt_inq_com_timeout - Returns the communications time-out value
                              in a binding handle

   Used by client applications.

 SYNOPSIS

   #include <dce/rpc.h>

   void rpc_mgmt_inq_com_timeout( rpc_binding_handle_t binding,
                                  unsigned32 *timeout,
                                  unsigned32 *status );

 PARAMETERS

   Input

   binding
       Specifies a server binding handle.

   Output

   timeout
       Returns the communications time-out value from the binding
       parameter.

   status
       Returns the status code from this routine.  This status code
       indicates whether the routine completed successfully or, if
       not, why not.  The possible status codes and their meanings
       are as follows:

       rpc_s_ok      Success.

       rpc_s_invalid_binding
                     Invalid binding handle.

       rpc_s_wrong_kind_of_binding
                     Wrong kind of binding for operation.

 DESCRIPTION

   The rpc_mgmt_inq_com_timeout() routine returns the communications
   timeout value in a server binding handle. The time-out value
   specifies the relative amount of time to spend trying to communicate
   with the server. Depending on the protocol sequence for the
   specified binding handle, the value in timeout acts only as advice
   to the RPC runtime.

   The rpc_mgmt_set_com_timeout reference page explains the time-out
   values returned in timeout.

   To change the timeout value, a client calls
   rpc_mgmt_set_com_timeout().

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_mgmt_set_com_timeout