RpcSsSwapClientAllocFree function (rpcndr.h)

Article
02/22/2024

The RpcSsSwapClientAllocFree function exchanges the memory allocation and release mechanisms used by the client stubs with those supplied by the client.

Syntax

void RpcSsSwapClientAllocFree(
  RPC_CLIENT_ALLOC *ClientAlloc,
  RPC_CLIENT_FREE  *ClientFree,
  RPC_CLIENT_ALLOC **OldClientAlloc,
  RPC_CLIENT_FREE  **OldClientFree
);

Parameters

ClientAlloc

New function to allocate memory.

ClientFree

New function to release memory.

OldClientAlloc

Returns the previous memory-allocation function.

OldClientFree

Returns the previous memory-freeing function.

Return value

Value	Meaning
RPC_S_OK	The call succeeded.
RPC_S_OUT_OF_MEMORY	The system is out of memory.

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

Remarks

RpcSsSwapClientAllocFree exchanges the current memory allocation and memory freeing mechanisms with those supplied by the client.

Note RpcSsSwapClientAllocFree raises exceptions, unlike RpcSmSwapClientAllocFree, which returns the error code.

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