NAME

   rpc_sm_destroy_client_context - Reclaims the client memory resources
                                   for a context handle, and sets the
                                   context handle to null

 SYNOPSIS

   #include <rpc.h>
   void rpc_sm_destroy_client_context(
                  idl_void_p_t p_unusable_context_handle,
                  unsigned32 *status );

 PARAMETERS

   Input

   p_unusable_context_handle
             Specifies the context handle that can no longer be accessed.

   Output

   status    Returns the status code from this routine.  This status code
             indicates whether the routine completed successfully or, if
             not, why not.

             Possible status codes and their meanings include:

             rpc_s_ok      Success.

 DESCRIPTION

   The rpc_sm_destroy_client_context routine is used by client
   applications to reclaim the client resources used in maintaining
   an active context handle.  Applications call this routine after a
   communications error makes the context handle unusable.  When the
   rpc_sm_destroy_client_context routine reclaims the memory resources,
   it also sets the context handle to null.

 RETURN VALUES

   None.