NAME

rpc_sm_free — Frees memory allocated by the rpc_sm_allocate() routine

Synopsis

void rpc_sm_free(
idl_void_p_t node_to_free,
unsigned32 ∗status);

Parameters

Input

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

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

Applications call rpc_sm_free() to release memory allocated by rpc_sm_allocate(). 

When the stub allocates memory within the stub memory management environment, manager code called from the stub can also use rpc_sm_free() to release memory allocated by the stub. 

The thread calling rpc_sm_free() must have the same thread handle as the thread that allocated the memory with rpc_sm_allocate().  Applications pass thread handles from thread to thread by calling rpc_sm_get_thread_handle() and rpc_sm_set_thread_handle(). 

Return Values

None. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

rpc_s_ok
Success.

Related Information

Functions: rpc_sm_allocate(3rpc), rpc_sm_get_thread_handle(3rpc), rpc_sm_set_thread_handle(3rpc).