NAME

rpc_mgmt_set_cancel_timeout — Sets the lower bound on the time to wait before timing out after forwarding a cancel;  used by client applications

Synopsis

void rpc_mgmt_set_cancel_timeout(
signed32 seconds,
unsigned32 ∗status);

Parameters

Input

secondsAn 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

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_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 timeout applies to all remote procedure calls made in the current thread.  A multithreaded client that wishes to change the timeout 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), pthread_setcancel(3thr).