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

Статья
03/15/2023

Функция RpcNsProfileEltInqNext возвращает по одному элементу за раз из профиля.

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

Синтаксис

RPC_STATUS RpcNsProfileEltInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_CSTR      *MemberName,
  unsigned long *Priority,
  RPC_CSTR      *Annotation
);

Параметры

InquiryContext

Дескриптор службы имен, возвращенный функцией RpcNsProfileEltInqBegin .

IfId

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

MemberName

Возвращает указатель на указатель на имя элемента профиля. Синтаксис возвращаемого имени был указан с помощью параметра MemberNameSyntax в функции RpcNsProfileEltInqBegin .

Укажите значение NULL, чтобы запретить RpcNsProfileEltInqNext возвращать параметр MemberName . В этом случае приложение не вызывает функцию RpcStringFree .

Priority

Возвращает указатель на приоритет элемента профиля.

Annotation

Возвращает указатель на строку заметки для элемента профиля. Если в элементе профиля нет строки заметки, возвращается строка \0.

Укажите значение NULL, чтобы запретить RpcNsProfileEltInqNext возвращать параметр Annotation . В этом случае приложению не нужно вызывать функцию RpcStringFree .

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INCOMPLETE_NAME	Имя является неполным.
RPC_S_NAME_SERVICE_UNAVAILABLE	Служба имен недоступна.
RPC_S_NO_MORE_ELEMENTS	Больше нет элементов.

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

Функция RpcNsProfileEltInqNext возвращает один элемент из профиля, заданного параметром ProfileName в RpcNsProfileEltInqBegin. Независимо от значения InquiryType в RpcNsProfileEltInqBegin, RpcNsProfileEltInqNext возвращает все компоненты (идентификация интерфейса, имя члена, приоритет, строка заметки) элемента профиля.

Приложение может просматривать все выбранные записи профиля, многократно вызывая функцию RpcNsProfileEltInqNext . После просмотра всех элементов эта функция возвращает код состояния RPC_S_NO_MORE_ELEMENTS. Возвращаемые элементы не упорядочены.

При каждом вызове RpcNsProfileEltInqNext , который возвращает элемент профиля, библиотека времени выполнения RPC выделяет память для возвращенного имени члена и строки заметки. Приложение отвечает за вызов функции RpcStringFree для каждого возвращаемого имени члена и строки заметки. После просмотра элементов профиля приложение должно вызвать RpcNsProfileEltInqDone , чтобы освободить контекст запроса.

Примечание Windows 2000 Active Directory поддерживает эту функцию. Более ранние версии Windows NT поддерживают использование этой функции только со службой каталогов ячеек (CDS).

Примечание

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

Требования

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

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

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree

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