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

Статья
11/20/2024

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

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

Синтаксис

RPC_STATUS RpcNsEntryObjectInqBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_NS_HANDLE *InquiryContext
);

Параметры

EntryNameSyntax

Синтаксис для использования в EntryName.

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

EntryName

Указатель на имя записи базы данных name-service, для которой необходимо просмотреть идентификаторы UUID объекта.

InquiryContext

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

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

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_NAME_SYNTAX	Недопустимый синтаксис имени.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Синтаксис имени не поддерживается.
RPC_S_INCOMPLETE_NAME	Имя является неполным.
RPC_S_ENTRY_NOT_FOUND	Запись службы имен не найдена.
RPC_S_NAME_SERVICE_UNAVAILABLE	Служба имен недоступна.

Примечание Список допустимых кодов ошибок см. в разделе возвращаемых значений RPC.

Замечания

Функция RpcNsEntryObjectInqBegin создает контекст запроса для просмотра объектов UUID, экспортированных в EntryName.

Перед вызовом функции RpcNsEntryObjectInqNext приложение должно сначала вызвать RpcNsEntryObjectInqBegin для создания контекста запроса.

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	rpcnsi.h (include Rpc.h)
библиотеки	Rpcns4.lib
DLL	Rpcns4.dll

См. также

RpcNsBindingExport

RpcNsEntryObjectInqDone

RpcNsEntryObjectInqNext

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