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

#include <dce/rpc.h>
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.  The possible status code and its meaning is as follows:

rpc_s_okSuccess. 

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. 

RETURN VALUES

None.