rpc_sm_free(3rpc)

Synopsis

#include <rpc.h>

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

status
Returns 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)