RpcSsSetClientAllocFree 函式 (rpcndr.h)
RpcSsSetClientAllocFree 函式會啟用用戶端存根所使用的記憶體配置和釋放機制。
語法
void RpcSsSetClientAllocFree(
RPC_CLIENT_ALLOC *ClientAlloc,
RPC_CLIENT_FREE *ClientFree
);
參數
ClientAlloc
記憶體配置函式。
ClientFree
記憶體釋放函式搭配 pfnAllocate 所指定的記憶體配置函式使用。
傳回值
值 | 意義 |
---|---|
|
系統記憶體不足。 |
注意 如需有效錯誤碼的清單,請參閱 RPC 傳回值。
備註
藉由覆寫用戶端存根用來管理記憶體的預設例程, RpcSsSetClientAllocFree 會建立記憶體配置和記憶體釋放機制。 請注意,除非遠端呼叫發生在管理員程式代碼內,否則預設例程是免費的和 malloc。 在此情況下,預設記憶體管理例程為 RpcSsFree 和 RpcSsAllocate。
請注意, 當 RpcSsSetClientAllocFree 回收記憶體資源時,也會讓內容處理 NULL。
注意RpcSsSetClientAllocFree 會引發例外狀況,不同於 RpcSmSetClientAllocFree,這會傳回錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | rpcndr.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |