RpcSsSwapClientAllocFree function (rpcndr.h)

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

See also

RpcSmSwapClientAllocFree

RpcSsAllocate

RpcSsFree

RpcSsSetClientAllocFree