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

Статья
08/25/2023

Функция 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.

Приложение может просматривать все экспортированные 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

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