rpc_mgmt_set_com_timeout- sets the communication timeout value in a binding handle
void rpc_mgmt_set_com_timeout( rpc_binding_handle_t binding, unsigned32 timeout, unsigned32 *status);
- Specifies the server binding handle whose timeout value is set.
- Specifies a communications timeout value.
- Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.
Possible status codes and their meanings include:
The rpc_mgmt_set_com_timeout() routine resets the communications timeout value in a server binding handle. The timeout argument 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 timeout argument acts only as advice to the RPC run-time system.
After the initial relationship is established, subsequent communications for the binding handle can revert to not less than the default timeouts for the protocol service. This means that after setting a short initial timeout for establishing a connection, calls in progress are not timed out any sooner than the default.
The timeout value can be any of the following:
Attempts to communicate for the minimum amount of time for the network protocol being used. This value favours response time over correctness in determining whether the server is running.
Attempts to communicate for an average amount of time for the network protocol being used. This value gives equal consideration to response time and correctness in determining whether a server is running. This is the default value.
Attempts to communicate for the longest finite amount of time for the network protocol being used. This value favours correctness in determining whether a server is running over response time.
Attempts to communicate forever.
Note that these values represent relative, rather than absolute, values.
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.