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

Статья
03/15/2023

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

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

Синтаксис

RPC_STATUS RpcNsProfileEltInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_WSTR      *MemberName,
  unsigned long *Priority,
  RPC_WSTR      *Annotation
);

Параметры

InquiryContext

Дескриптор name-service, возвращенный функцией RpcNsProfileEltInqBegin .

IfId

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

MemberName

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

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

Priority

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

Annotation

Возвращает указатель на указатель на строку заметки для элемента профиля. Если в элементе profile нет строки заметки, возвращается строка \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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree

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