rpcBindingReset 函数 (rpcdce.h)

  • 项目

RpcBindingReset 函数重置绑定句柄，以便指定主机，但未指定该主机上的服务器。

语法

RPC_STATUS RpcBindingReset(
  RPC_BINDING_HANDLE Binding
);

parameters

Binding

要重置的服务器绑定句柄。

返回值

值 含义
RPC_S_OK
 调用成功。
RPC_S_INVALID_BINDING
 绑定句柄无效。
RPC_S_WRONG_KIND_OF_BINDING
 这是操作的错误绑定类型。
 
注意 有关有效错误代码的列表，请参阅 RPC 返回值。
 

注解

客户端调用 RpcBindingReset 函数以取消特定服务器实例与 Binding 参数中指定的服务器绑定句柄的关联。 RpcBindingReset 函数通过删除绑定句柄中的服务器地址的终结点部分来取消关联服务器实例。 主机在绑定句柄中保持不变。 结果是部分绑定的服务器绑定句柄。

RpcBindingReset 不会影响 Binding 参数的身份验证信息（如果有）。

如果客户端愿意由绑定句柄中指定的主机上的任何兼容服务器实例提供服务，则客户端会在使用绑定句柄进行远程过程调用之前调用 RpcBindingReset 函数。 客户端不得为要对其执行调用的绑定句柄调用 RpcBindingReset 函数。

当客户端使用重置 (部分绑定) 绑定进行下一个远程过程调用时，客户端的 RPC 运行时库使用客户端接口规范中的已知终结点（如果有）。 否则，客户端的运行时库会自动与指定远程主机上的终结点映射服务通信，以便从终结点映射数据库中获取兼容服务器的终结点。 如果找到兼容的服务器，则 RPC 运行时库使用新终结点更新绑定。 如果未找到兼容的服务器，远程过程调用将失败。 对于使用 ncacn) (连接协议的调用，EPT_S_NOT_REGISTERED状态代码将返回到客户端。 对于使用 ncadg) (数据报协议的调用，RPC_S_COMM_FAILURE状态代码将返回到客户端。

如果服务器希望可供对重置绑定句柄进行远程过程调用的客户端使用，则服务器应用程序应通过调用 RpcEpRegister 和 RpcEpRegisterNoReplace 来注册所有绑定句柄。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 rpcdce.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

请参阅

RpcEpRegister

RpcEpRegisterNoReplace