NAME

rpc_sm_client_free — Frees memory returned from a client stub

Synopsis

void rpc_sm_client_free(
idl_void_p_t node_to_free,
unsigned32 ∗status);

Parameters

Input

node_to_free
Specifies a pointer to memory returned from a client stub.

Output

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

Description

The rpc_sm_client_free() routine releases memory allocated and returned from a client stub.  The thread calling rpc_sm_client_free() must have the same thread handle as the thread that made the RPC call.  Applications pass thread handles from thread to thread by calling rpc_sm_get_thread_handle() and rpc_sm_set_thread_handle(). 

This routine enables a routine to deallocate dynamically allocated memory returned by an RPC call without knowledge of the memory management environment from which it was called. 

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_free(3rpc), rpc_sm_get_thread_handle(3rpc), rpc_sm_set_client_alloc_free(3rpc), rpc_sm_set_thread_handle(3rpc), rpc_sm_swap_client_alloc_free(3rpc).