RpcSmClientFree function (rpcndr.h)

Article
02/22/2024

The RpcSmClientFree function frees memory returned from a client stub.

Syntax

RPC_STATUS RpcSmClientFree(
  void *pNodeToFree
);

Parameters

pNodeToFree

Pointer to memory returned from a client stub.

Return value

Value	Meaning
RPC_S_OK	The call succeeded.

Note For a list of valid error codes, see RPC Return Values.

Remarks

The RpcSmClientFree function releases memory allocated and returned from a client stub. The memory management handle of the thread calling this function 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 function to free dynamically-allocated memory returned by an RPC call without knowing the memory-management environment from which it was called.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps \| UWP apps]
Minimum supported server	Windows 2000 Server [desktop apps \| UWP apps]
Target Platform	Windows
Header	rpcndr.h (include Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll