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

Статья
11/20/2024

Функция RpcNsMgmtEntryInqIfIds возвращает список интерфейсов, экспортированных в запись службы имен—базы данных. Он также возвращает вектор идентификации интерфейса, содержащий интерфейсы дескрипторов привязки, экспортированных сервером в EntryName. Эта функция использует срок действия 0, что приводит к немедленному обновлению локальной копии данных службы имен.

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

Синтаксис

RPC_STATUS RpcNsMgmtEntryInqIfIdsA(
  unsigned long    EntryNameSyntax,
  RPC_CSTR         EntryName,
  RPC_IF_ID_VECTOR **IfIdVec
);

Параметры

EntryNameSyntax

Синтаксис EntryName.

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

EntryName

Указатель на имя записи службы-базы данных name, для которой возвращается вектор идентификации интерфейса.

IfIdVec

Возвращает адрес указателя на вектор идентификации интерфейса.

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

Ценность	Значение
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.

Замечания

Функция RpcNsMgmtEntryInqIfIds возвращает вектор идентификации интерфейса, содержащий интерфейсные дескрипторы привязки, экспортированные сервером в EntryName. Эта функция использует срок действия 0, что приводит к немедленному обновлению локальной копии данных службы имен. Вызывающее приложение отвечает за вызов функции RpcIfIdVectorFree для освобождения памяти, используемой вектором.

Заметка

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

Требования

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

См. также

RpcIfIdVectorFree

RpcIfInqId

RpcNsBindingExport

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