rpcSmDestroyClientContext 函式 (rpcndr.h)

  • 發行項

RpcSmDestroyClientContext 函式會回收內容句柄的用戶端記憶體資源，並使內容句柄變成 NULL。

語法

RPC_STATUS RpcSmDestroyClientContext(
  void **ContextHandle
);

參數

ContextHandle

無法再使用的內容句柄。 在 RpcSMDestroyClientContext 傳回之前，句柄會設定為 NULL。

傳回值

值 意義
RPC_S_OK
 呼叫成功。
RPC_X_SS_CONTEXT_MISMATCH
 控制代碼無效。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

備註

用戶端應用程式會使用 RpcSmDestroyClientContext 從非使用中的內容句柄回收資源。 應用程式可以在通訊錯誤導致內容句柄無法使用之後呼叫 RpcSmDestroyClientContext 。 RpcSmDestroyClientContext 函式提供與 RpcSsDestroyClientContext 函式相同的功能。

此函式不會叫用伺服器的內容句柄執行進程。

當 RpcSmDestroyClientContext 回收記憶體資源時，它也會讓內容句柄 NULL。 如需詳細資訊，請參閱 使用內容句柄。

規格需求

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

另請參閱

RpcSsDestroyClientContext