rpc_mgmt_set_cancel_timeout(3rpc)

Used by client applications.

Synopsis

#include <dce/rpc.h>

void rpc_mgmt_set_cancel_timeout(

signed32 seconds,

unsigned32 *status);

Parameters

Input

seconds
An integer specifying the number of seconds to wait for a server to acknowledge a cancel. To specify that a client waits an infinite amount of time, supply the value rpc_c_cancel_infinite_timeout.

Output

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

Description
The rpc_mgmt_set_cancel_timeout( ) routine resets the amount of time the RPC runtime waits for a server to acknowledge a cancel before orphaning the call.

The application specifies either to wait forever or to wait a length of time specified in seconds. If the value of seconds is 0 (zero), the remote procedure call is immediately orphaned when the RPC runtime detects and forwards a pending cancel; control returns immediately to the client application. The default value, rpc_c_cancel_infinite_timeout, specifies waiting forever for the call to complete.

The value for the cancel time-out applies to all remote procedure calls made in the current thread. A multithreaded client that wishes to change the time-out value must call this routine in each thread of execution.

For more information about canceled threads and orphaned remote procedure calls, see the OSF DCE Application Development Guide - Directory Services.

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.

Related Information
Functions: pthread_cancel(3thr). See DCE Threads documentation.

pthread_setcancel(3thr). See DCE Threads documentation.

Books: OSF DCE Application Development Guide - Directory Services