RpcSmFree 函式 (rpcndr.h)

RpcSmFree 函式會釋放 RpcSmAllocate 所配置的記憶體。

語法

RPC_STATUS RpcSmFree(
  void *NodeToFree
);

NodeToFree

RpcSmAllocate 或 RpcSsAllocate 所配置的記憶體指標。

RpcSmFree 函式會傳回下列值。

值	意義
RPC_S_OK	呼叫成功。

注意如需有效錯誤碼的清單，請參閱 RPC 傳回值。

應用程式會使用 RpcSmFree 來釋放 RpcSmAllocate 所配置的記憶體。如果存根配置應用程式的記憶體， RpcSmFree 也可以用來釋放記憶體。如需詳細資訊，請參閱記憶體管理。

為了改善效能， RpcSmFree 函式只會標示要釋放的記憶體。在您的應用程式呼叫 RpcSmDisableAllocate 函式之前，不會實際釋放記憶體。若要立即釋放記憶體，請叫用 midl_user_free 函式。

請注意，呼叫 RpcSmFree 之線程的句柄必須符合呼叫 RpcSmAllocate 來配置記憶體的線程句柄。使用 RpcSmGetThreadHandle 和 RpcSmSetThreadHandle 將句柄從線程傳遞至線程。

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	rpcndr.h (包含 Rpc.h)
程式庫	Rpcrt4.lib
Dll	Rpcrt4.dll