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

另请参阅

RpcSsDestroyClientContext