Функция RpcNsMgmtEntryInqIfIdsA (rpcnsi.h)
Функция RpcNsMgmtEntryInqIfIds возвращает список интерфейсов, экспортированных в запись service-database. Он также возвращает вектор идентификации интерфейса, содержащий интерфейсы дескрипторов привязки, экспортированных сервером в EntryName. Эта функция использует срок действия 0, что приводит к немедленному обновлению локальной копии данных службы имен.
Синтаксис
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
Указатель на имя записи "служба—база данных", для которого возвращается вектор идентификации интерфейса.
IfIdVec
Возвращает адрес указателя на вектор идентификации интерфейса.
Возвращаемое значение
Значение | Значение |
---|---|
|
Вызов выполнен успешно. |
|
Недопустимый синтаксис имени. |
|
Синтаксис имени не поддерживается. |
|
Имя является неполным. |
|
Запись name-service не найдена. |
|
Служба имен недоступна. |
Комментарии
Функция RpcNsMgmtEntryInqIfIds возвращает вектор идентификации интерфейса, содержащий интерфейсы дескрипторов привязки, экспортированных сервером, в EntryName. Эта функция использует срок действия 0, что приводит к немедленному обновлению локальной копии данных службы имен. Вызывающее приложение отвечает за вызов функции RpcIfIdVectorFree для освобождения памяти, используемой вектором.
Примечание
Заголовок rpcnsi.h определяет RpcNsMgmtEntryInqIfIds в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | rpcnsi.h (включая Rpc.h) |
Библиотека | Rpcns4.lib |
DLL | Rpcns4.dll |