RpcMgmtSetCancelTimeout
The RpcMgmtSetCancelTimeout
function sets the lower bound on the time to wait before timing out after
forwarding a cancel.
This function
is supported only by Windows NT.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcMgmtSetCancelTimeout(
|
signed int Seconds |
|
|
); |
|
Parameters
Seconds
An integer
specifying the number of seconds to wait for a server to acknowledge a cancel.
To specify that a client waits an indefinite amount of time, supply the value
RPC_C_CANCEL_INFINITE_TIMEOUT.
Remarks
An
application calls the RpcMgmtSetCancelTimeout routine to reset the
amount of time the run-time library waits for a server to acknowledge a cancel.
The application specifies either to wait forever or to wait a specified length
of time in seconds. If the value of Seconds is 0 (zero), the call is
immediately abandoned upon a cancel and control returns to the client
application. The default value is RPC_C_CANCEL_INFINITE_TIMEOUT, which
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. To change the time-out value, a multithreaded client must call this
routine in each thread of execution.
Note This routine
is only supported for Windows NT clients.
Return Values
|
Value |
Meaning |
|
RPC_S_OK |
Success |
|
RPC_S_CANNOT_SUPPORT |
Called from
an MS-DOS or Windows 3.x client |