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 |