NAME

rpc_sm_free- frees memory allocated by the rpc_sm_allocate() routine

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. The status code indicates whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

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. (See Introduction to the RPC API for a description of stub memory management.)

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 VALUE

None.

SEE ALSO

rpc_sm_allocate\^()
rpc_sm_get_thread_handle()
rpc_sm_set_thread_handle\^().