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

Статья
03/01/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, для которой необходимо просмотреть идентификаторы UUID объекта.

InquiryContext

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

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

Значение	Значение
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.

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

Требования

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

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

RpcNsBindingExport

RpcNsEntryObjectInqDone

RpcNsEntryObjectInqNext

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