/sys$common/syshlp/helplib.hlb DCE_RPC, Application Routines, rpc_ss_free  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   rpc_ss_free - Frees memory allocated by the rpc_ss_allocate() routine

   Used by server or possibly by client applications.

 SYNOPSIS

   #include <dce/rpc.h>

   void rpc_ss_free( idl_void_p_t node_to_free );

 PARAMETERS

   Input

   node_to_free
          Specifies a pointer to memory allocated by rpc_ss_allocate().

   Note that in ANSI standard C environments, idl_void_p_t is defined
   as void * and in other environments is defined as char *.

 DESCRIPTION

   The rpc_ss_free() routine releases memory allocated by
   rpc_ss_allocate().  The thread calling rpc_ss_free() must have
   the same thread handle as the thread that allocated the memory
   with rpc_ss_allocate().  Use it only in an environment where
   rpc_ss_allocate() is used.

   If the manager code allocates memory with rpc_ss_allocate() and the
   memory is not released by rpc_ss_free() during manager code execution,
   then the server stub automatically releases the memory when the
   manager code completes execution and returns control to the stub.

   Manager code can also use rpc_ss_free() to release memory that is
   pointed to by a full pointer in an input parameter.

   For information about rules for using memory management routines,
   see the OSF DCE Application Development Guide.

 RELATED INFORMATION

   Functions: rpc_ss_allocate
              rpc_ss_get_thread_handle
              rpc_ss_set_thread_handle

   Books: OSF DCE Application Development Guide