| ## rpc_mgmt_set_cancel_timeout(3rpc) 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 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 ##