NAME

rpc_mgmt_set_com_timeout- sets the communication timeout value in a binding handle

SYNOPSIS

#include <dce/rpc.h>

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

PARAMETERS

Input

binding

Specifies the server binding handle whose timeout value is set.

timeout

Specifies a communications timeout value.

Output

status

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:

rpc_s_ok

Success.

DESCRIPTION

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:

rpc_c_binding_min_timeout

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.

rpc_c_binding_default_timeout

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

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.

rpc_c_binding_infinite_timeout

Attempts to communicate forever.

Note that these values represent relative, rather than absolute, values.

RETURN VALUE

None.

SEE ALSO

rpc_mgmt_inq_com_timeout().

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.