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

   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.  The possible status code and its meaning is as
       follows:

       rpc_s_ok
               Success.

 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.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: pthread_cancel
              pthread_setcancel

   Books: OSF DCE Application Development Guide.