rpc_mgmt_set_com_timeout(3) — Subroutines
NAME
rpc_mgmt_set_com_timeout - Sets the communication timeout value in a binding handle
Used by client applications.
SYNOPSIS
#include <dce/rpc.h>
void rpc_mgmt_set_com_timeout(
rpc_binding_handle_t binding ,
unsigned32 timeout ,
unsigned32 ∗status );
PARAMETERS
Input
bindingSpecifies the server binding handle whose timeout value is set.
timeoutSpecifies a communication timeout value.
Output
statusReturns 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_okSuccess.
rpc_s_invalid_bindingInvalid binding handle.
rpc_s_invalid_timeoutInvalid timeout value.
rpc_s_wrong_kind_of_binding
Wrong kind of binding for operation.
DESCRIPTION
The rpc_mgmt_set_com_timeout routine resets the communication 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 timeout value acts only as advice to the RPC runtime.
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 establishing a connection, calls in progress are not timed out any sooner than the default.
The timeout value can be any integer value from 0 (zero) to 10. Note that these values do not represent seconds. They represent a relative amount of time to spend to establish a client-server relationship (a binding).
Constants are provided for certain values in the timeout range. The following table of binding timeout values describes the RPC predefined values that an application can use for the timeout argument:
Table 0-0. Predefined Timeout Values
| Name | Value | Description |
| rpc_c_binding_min_timeout | 0 | Attempts to communicate for the minimum amount of time for the network protocol being used. This value favors response time over correctness in determining whether the server is running. |
| rpc_c_binding_default_timeout | 5 | 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. |
| rpc_c_binding_max_timeout | 9 | Attempts to communicate for the longest finite amount of time for the network protocol being used. This value favors correctness in determining whether a server is running over response time. |
| rpc_c_binding_infinite_timeout | 10 | Attempts to communicate forever. |
RETURN VALUES
None.
RELATED INFORMATION
Functions: rpc_mgmt_inq_com_timeout(3)