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_* 错误代码。

注解

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

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

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

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

要求

请参阅

RpcBindingBind

RpcBindingFree