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) |
Library | Rpcrt4.lib |
DLL | Rpcrt4.dll |