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

Статья
11/20/2024

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

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

Синтаксис

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

Параметры

InquiryContext

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

IfId

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

MemberName

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

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

Priority

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

Annotation

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

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

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

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

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

Замечания

Функция RpcNsProfileEltInqNext возвращает один элемент из профиля, указанного параметр ом ProfileName в RpcNsProfileEltInqBegin. Независимо от значения ЗапросаType в 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	rpcnsi.h (include Rpc.h)
библиотеки	Rpcns4.lib
DLL	Rpcns4.dll

См. также

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree

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