NAME

rpc_ss_free — Frees memory allocated by the rpc_ss_allocate() routine;  used by server or possibly by client applications

Synopsis

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—Core Components. 

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

Related Information

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

Books: OSF DCE Application Development Guide—Core Components.