RpcNsBindingSelect 函数 (rpcnsi.h)
RpcNsBindingSelect 函数从兼容的绑定句柄列表中返回绑定句柄。
注意 Windows Vista 及更高版本的操作系统不支持此功能。
语法
RPC_STATUS RpcNsBindingSelect(
RPC_BINDING_VECTOR *BindingVec,
RPC_BINDING_HANDLE *Binding
);
参数
BindingVec
指向从中选择绑定句柄的客户端兼容服务器绑定句柄向量的指针。 返回的绑定向量不再引用所选绑定句柄，该句柄在 Binding 参数中单独返回。
Binding
指向所选绑定句柄的指针。
返回值
| 值 | 含义 |
|---|---|
|
调用成功。 |
|
不再有绑定。 |
注意 有关有效错误代码的列表，请参阅 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 |