VMS Help DCE_RPC, Application Routines, rpc_sm_client_free  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   rpc_sm_client_free - Frees memory returned from a client stub

 SYNOPSIS

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

 PARAMETERS

   Input

   node_to_free
             Specifies a pointer to memory returned from a client stub.

   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_client_free routine releases memory allocated and returned
   from a client stub. The thread calling rpc_sm_client_free must have the
   same thread handle as the thread that made the RPC call.  Applications
   pass thread handles from thread to thread by calling
   rpc_sm_get_thread_handle and rpc_sm_set_thread_handle.

   This routine enables a routine to deallocate dynamically allocated
   memory returned by an RPC call without knowledge of the memory
   management environment from which it was called.

 RETURN VALUES

   None.

 RELATED INFORMATION

   Functions: rpc_sm_free
              rpc_sm_get_thread_handle
              rpc_sm_set_client_alloc_free
              rpc_sm_set_thread_handle
              rpc_sm_swap_client_alloc_free