RpcSsSwapClientAllocFree function

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

Syntax

C++


void RPC_ENTRY RpcSsSwapClientAllocFree(
   RPC_CLIENT_ALLOC *pfnAllocate,
   RPC_CLIENT_FREE  *pfnFree,
   RPC_CLIENT_ALLOC **pfnOldAllocate,
   RPC_CLIENT_FREE  **pfnOldFree
);

Parameters

pfnAllocate: New function to allocate memory.
pfnFree: New function to release memory.
pfnOldAllocate: Returns the previous memory-allocation function.
pfnOldFree: 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

Minimum supported client	Windows 2000 Professional [desktop apps \| Windows Store apps]
Minimum supported server	Windows 2000 Server [desktop apps \| Windows Store apps]
Minimum supported phone	Windows Phone 8.1
Header	Rpcndr.h (include Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll