rpc_sm_client_free(3rpc)

Synopsis

#include <rpc.h>

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

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