RpcSmFree 函式 (rpcndr.h)
RpcSmFree 函式會釋放 RpcSmAllocate 所配置的記憶體。
語法
RPC_STATUS RpcSmFree(
void *NodeToFree
);
參數
NodeToFree
RpcSmAllocate 或 RpcSsAllocate 所配置的記憶體指標。
傳回值
RpcSmFree 函式會傳回下列值。
| 值 | 意義 |
|---|---|
|
呼叫成功。 |
注意 如需有效錯誤碼的清單，請參閱 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 |