rpcBindingUnbind 函数 (rpcasync.h)

RpcBindingUnbind 函数取消绑定以前由 RpcBindingBind 绑定的绑定句柄。

语法

RPC_STATUS RpcBindingUnbind(
  [in] RPC_BINDING_HANDLE Binding
);

parameters

[in] Binding

RPC_BINDING_HANDLE 结构,其中包含要从 RPC 服务器取消绑定的绑定句柄。

返回值

此函数在成功时返回RPC_S_OK;否则,将返回RPC_S_* 错误代码。

注意 有关有效错误代码的列表,请参阅 RPC 返回值
 

注解

RpcBindingUnbind 从 RPC 服务器取消绑定以前绑定的绑定句柄。 可以使用 RpcBindingSetOptionRpcBindingSetAuthInfoEx 等调用修改未绑定句柄。 可以再次绑定处于未绑定状态的绑定句柄并重新用于进行调用。

如果在取消绑定时当前正在进行 RPC 调用的绑定句柄上调用取消绑定操作,则取消绑定操作的结果为未定义。 调用方负责确保在尝试取消绑定操作时没有正在进行的调用。

请注意,调用 RpcBindingUnbind 不一定断开客户端与服务器的连接。 它将使绑定句柄使用的任何缓存信息失效,但实际上无法确保断开连接。 若要确保断开连接,请使用 RpcBindingFree 释放绑定句柄。

Windows Vista: 目前,此函数仅支持 ncalrpc 协议序列。

要求

   
最低受支持的客户端 Windows Vista、Windows XP SP2 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008、Windows Server 2003 SP1 [桌面应用 |UWP 应用]
目标平台 Windows
标头 rpcasync.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

请参阅

RpcBindingBind

RpcBindingFree