RpcSmClientFree

The RpcSmClientFree function frees memory returned from a client stub.

#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcSmClientFree( 
  void  *  NodeToFree  
);

Parameters

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

Remarks

The RpcSmClientFree routine releases memory allocated and returned from a client stub. The memory management handle of the thread calling this routine must match the handle of the thread that made the RPC call. Use RpcSmGetThreadHandle and RpcSmSetThreadHandle to pass handles from thread to thread.

Note that using RpcSmClientFree allows a routine to free dynamically-allocated memory returned by an RPC call without knowing the memory management environment from which it was called.

Return Values

Value Meaning
RPC_S_OK Success

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcndr.h.
  Import Library: Link with rpcrt4.lib.

See Also

RpcSmFree, RpcSmGetThreadHandle, RpcSmSetClientAllocFree, RpcSmSetThreadHandle, RpcSmSwapClientAllocFree