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_freeSpecifies a pointer to memory allocated by rpc_ss_allocate. 

(Note: In ANSI standard C environments, idl_void_p_t is defined as void ∗ and in other environments is defined as char ∗.) 

DESCRIPTION

This 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. 

See the Rules for Using Memory Management Routines in the Pointers section of the Interface Definition Language chapter in the NCS 2.0 Programmer’s Guide. 

RELATED INFORMATION

Functions: rpc_ss_allocate(3), rpc_ss_get_thread_handle(3), rpc_ss_set_thread_handle(3)