Функция RpcNsBindingSelect (rpcnsi.h)
Функция RpcNsBindingSelect возвращает дескриптор привязки из списка совместимых дескрипторов привязки.
Синтаксис
RPC_STATUS RpcNsBindingSelect(
RPC_BINDING_VECTOR *BindingVec,
RPC_BINDING_HANDLE *Binding
);
Параметры
BindingVec
Указатель на вектор совместимых с клиентом дескрипторов привязки сервера, из которых выбран дескриптор привязки. Возвращаемый вектор привязки больше не ссылается на выбранный дескриптор привязки, который возвращается отдельно в параметре Binding .
Binding
Указатель на выбранный дескриптор привязки.
Возвращаемое значение
| Значение | Значение |
|---|---|
|
Вызов выполнен успешно. |
|
Больше нет привязок. |
Комментарии
Каждый раз, когда клиент вызывает функцию RpcNsBindingSelect , операция функции возвращает другой дескриптор привязки из вектора.
Когда все дескрипторы привязки были возвращены из вектора, функция возвращает состояние RPC_S_NO_MORE_BINDINGS и значение Binding со значением NULL.
Операция выбора выделяет хранилище для данных, на которые ссылается возвращаемый параметр Binding . Когда клиент завершает работу с дескриптором привязки, он должен вызвать функцию RpcBindingFree , чтобы освободить хранилище. Для каждого вызова RpcNsBindingSelect требуется соответствующий вызов функции RpcBindingFree .
Клиенты могут создавать собственные процедуры выбора, реализующие критерии выбора для конкретного приложения. В этом случае RpcStringBindingParse предоставляет доступ к полям привязки.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | rpcnsi.h (включая Rpc.h) |
| Библиотека | Rpcns4.lib |
| DLL | Rpcns4.dll |