rpc_ss_free(3rpc)

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