NAME

rpc_sm_client_free-frees memory returned from a client stub

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. 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

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 VALUE

None.

SEE ALSO

rpc_sm_free()
rpc_sm_get_thread_handle()
rpc_sm_set_client_alloc_free()
rpc_sm_set_thread_handle()
rpc_sm_swap_client_alloc_free().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.