Поделиться через

Функция RpcNsBindingLookupBeginA (rpcnsi.h)

  • Статья

Функция RpcNsBindingLookupBegin создает контекст поиска для интерфейса и объекта .

Примечание Эта функция не поддерживается в операционных системах Windows Vista и более поздних версий.
 

Синтаксис

RPC_STATUS RpcNsBindingLookupBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID          *ObjUuid,
  unsigned long BindingMaxCount,
  RPC_NS_HANDLE *LookupContext
);

Параметры

EntryNameSyntax

Синтаксис параметра EntryName .

Чтобы использовать синтаксис, указанный в записи значения реестра HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, укажите значение RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Указатель на имя записи, с которой начинается поиск совместимых привязок.

Чтобы использовать имя записи, указанной в записи значения реестра HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntry, укажите пустой указатель или пустую строку. В этом случае параметр EntryNameSyntax игнорируется, а библиотека времени выполнения использует синтаксис по умолчанию.

IfSpec

Структура, созданная заглушками, указывающая интерфейс для поиска. Если спецификация интерфейса не была экспортирована или не имеет никакого значения для вызывающей стороны, укажите значение NULL для этого параметра. В этом случае возвращаемые привязки гарантированно будут иметь только совместимую и поддерживаемую последовательность протоколов и содержать указанный объект UUID. Требуемый интерфейс может не поддерживаться контактным сервером.

ObjUuid

Указатель на необязательный объект UUID.

Для ненулевого UUID совместимые дескрипторы привязки возвращаются из записи, только если сервер экспортировал указанный объект UUID.

Для значения пустого указателя или nil UUID для этого параметра возвращаемые дескрипторы привязки содержат один из UID объекта, экспортированных совместимым сервером. Если сервер не экспортировал идентификаторы UUID объекта, возвращенные совместимые дескрипторы привязки содержат UUID объекта nil.

BindingMaxCount

Максимальное количество привязок, возвращаемых в параметре BindingVec из функции RpcNsBindingLookupNext .

Укажите нулевое значение, чтобы использовать число RPC_C_BINDING_MAX_COUNT_DEFAULT по умолчанию.

LookupContext

Возвращает указатель на дескриптор службы имен для использования с функциями RpcNsBindingLookupNext и RpcNsBindingLookupDone .

Возвращаемое значение

Значение Значение
RPC_S_OK
 Вызов выполнен успешно.
RPC_S_INVALID_NAME_SYNTAX
 Недопустимый синтаксис имени.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 Синтаксис имени не поддерживается.
RPC_S_INCOMPLETE_NAME
 Имя является неполным.
RPC_S_ENTRY_NOT_FOUND
 Запись name-service не найдена.
RPC_S_NAME_SERVICE_UNAVAILABLE
 Служба имен недоступна.
RPC_S_INVALID_OBJECT
 Недопустимый объект.
 
Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.
 

Комментарии

Функция RpcNsBindingLookupBegin создает контекст поиска для поиска совместимых с клиентом дескрипторов привязки на серверах, которые предлагают указанный интерфейс и объект.

Перед вызовом RpcNsBindingLookupNext клиентское приложение должно сначала вызвать RpcNsBindingLookupBegin для создания контекста подстановки. Параметры этой функции управляют работой функции RpcNsBindingLookupNext .

В windows 2000 среда RPC использует Active Directory в качестве базы данных службы имен и порядок, в котором среда выполнения выполняет поиск, выглядит следующим образом:

  • Выполните поиск в локальном кэше.
  • Если запись не найдена в локальном кэше, выполните поиск в Active Directory этого компьютера.
  • Если запись не найдена на локальном компьютере, отправьте широковещательные запросы ко всем остальным службам Active Directory в домене.

    Обратите внимание, что если запись существует в Active Directory, но с ней нет сведений, среда выполнения не будет выдавать этот широковещательный запрос.

По завершении поиска дескрипторов привязки клиентское приложение вызывает функцию RpcNsBindingLookupDone , чтобы удалить контекст подстановки.

Примечание

Заголовок rpcnsi.h определяет RpcNsBindingLookupBegin в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header rpcnsi.h (включая Rpc.h)
Библиотека Rpcns4.lib
DLL Rpcns4.dll

См. также раздел

RpcNsBindingLookupDone

RpcNsBindingLookupNext