rpcSsDestroyClientContext 函式 (rpcndr.h)

  • 發行項

RpcSsDestroyClientContext 函式會終結用戶端不再需要的內容句柄，而不需要連絡伺服器。

語法

void RpcSsDestroyClientContext(
  void **ContextHandle
);

參數

ContextHandle

要終結的內容句柄。 在 RpcSsDestroyClientContext 傳回之前，句柄會設定為 NULL。

傳回值

RpcSsDestroyClientContext 沒有傳回值。

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

備註

RpcSsDestroyClientContext 是由用戶端應用程式用來回收記憶體資源，以在用戶端上維護內容句柄。 當 ContextHandle 不再有效時，即會使用此函式，例如發生通訊失敗且不再提供伺服器時。 內容句柄設定為 NULL。 RpcSsDestroyClientContext 函式提供與 RpcSmDestroyClientContext 函式相同的功能。 此函式不會叫用伺服器的內容句柄執行進程。

請勿使用 RpcSsDestroyClientContext 來取代關閉內容句柄的伺服器函式。

如果傳遞給它的內容句柄無效， RpcSsDestroyClientContext 函 式可能會擲回RPC_X_SS_CONTEXT_MISMATCH例外狀況。 應用程式不應該將無效的內容句柄傳遞至此函式。 如果擲回例外狀況，表示呼叫程式代碼發生錯誤，因此應該調查並修正。

規格需求

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

另請參閱

RpcBindingReset

RpcSmDestroyClientContext