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

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

  • Статья

Функция RpcNsEntryObjectInqNext возвращает по одному объекту за раз из записи базы данных службы имен.

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

Синтаксис

RPC_STATUS RpcNsEntryObjectInqNext(
  RPC_NS_HANDLE InquiryContext,
  UUID          *ObjUuid
);

Параметры

InquiryContext

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

ObjUuid

Возвращает указатель на экспортируемый объект UUID.

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

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

Комментарии

Функция RpcNsEntryObjectInqNext возвращает один из UUID объекта, экспортированных в запись базы данных name-service, указанную параметром EntryName в функции RpcNsEntryObjectInqBegin .

Приложение может просматривать все экспортированные UUID объекта, многократно вызывая RpcNsEntryObjectInqNext. При просмотре всех UID объекта эта функция возвращает код состояния RPC_S_NO_MORE_MEMBERS. Возвращаемые идентификаторы UUID объекта не упорядочены.

Приложение предоставляет память для объекта UUID, возвращенного в параметре ObjUuid .

После просмотра идентификаторов UUID объекта приложение должно вызвать функцию RpcNsEntryObjectInqDone , чтобы освободить контекст запроса.

Порядок, в котором возвращаются идентификаторы UUID объекта, может отличаться для каждого просмотра записи. Это означает, что порядок, в котором UUID объекта возвращаются в приложение, может отличаться при каждом запуске приложения.

Требования

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

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

RpcNsBindingExport

RpcNsEntryObjectInqBegin

RpcNsEntryObjectInqDone