RpcNsBindingSelect 函数 (rpcnsi.h)

RpcNsBindingSelect 函数从兼容的绑定句柄列表中返回绑定句柄。

注意 Windows Vista 及更高版本的操作系统不支持此功能。

语法

RPC_STATUS RpcNsBindingSelect(
  RPC_BINDING_VECTOR *BindingVec,
  RPC_BINDING_HANDLE *Binding
);

BindingVec

指向从中选择绑定句柄的客户端兼容服务器绑定句柄向量的指针。返回的绑定向量不再引用所选绑定句柄，该句柄在 Binding 参数中单独返回。

Binding

指向所选绑定句柄的指针。

值	含义
RPC_S_OK	调用成功。
RPC_S_NO_MORE_BINDINGS	不再有绑定。

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

每次客户端调用 RpcNsBindingSelect 函数时，函数操作都会从向量返回另一个绑定句柄。

当所有绑定句柄都已从向量返回时，函数将返回状态RPC_S_NO_MORE_BINDINGS并返回 NULL 的 Binding 值。

选择操作为返回的 Binding 参数引用的数据分配存储。当客户端完成绑定句柄时，它应调用 RpcBindingFree 函数来解除分配存储。每次调用 RpcNsBindingSelect 都需要对 RpcBindingFree 函数进行相应的调用。

客户端可以创建自己的选择例程，以实现特定于应用程序的选择条件。在这种情况下， RpcStringBindingParse 提供对绑定字段的访问权限。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	rpcnsi.h (包括 Rpc.h)
Library	Rpcns4.lib
DLL	Rpcns4.dll