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

另请参阅

RpcBindingReset

RpcSmDestroyClientContext