NAME

rpc_mgmt_inq_com_timeout — Returns the communications timeout value in a binding handle;  used by client applications

Synopsis

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

Parameters

Input

bindingSpecifies a server binding handle. 

Output

timeoutReturns the communications timeout value from the binding parameter. 

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

The rpc_mgmt_inq_com_timeout() routine returns the communications timeout value in a server binding handle.  The timeout 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(3rpc) reference page explains the timeout values returned in timeout. 

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

Return Values

No value is returned. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

rpc_s_ok
Success.

rpc_s_invalid_binding
Invalid binding handle.

rpc_s_wrong_kind_of_binding
Wrong kind of binding for operation.

Related Information

Functions: rpc_mgmt_set_com_timeout(3rpc).