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

Статья
08/25/2023

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

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

Синтаксис

RPC_STATUS RpcNsProfileEltInqBeginA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  unsigned long InquiryType,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName,
  RPC_NS_HANDLE *InquiryContext
);

Параметры

ProfileNameSyntax

Синтаксис profileName.

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

ProfileName

Указатель на имя профиля для просмотра.

InquiryType

Тип запроса, выполняемого по профилю. В следующей таблице перечислены допустимые типы запросов.

Тип запроса	Значение
RPC_C_PROFILE_DEFAULT_ELT	Выполняет поиск элемента профиля по умолчанию в профиле, если таковой есть. Параметры IfId, VersOption и MemberName игнорируются.
RPC_C_PROFILE_ALL_ELTS	Возвращает каждый элемент из профиля. Параметры IfId, VersOption и MemberName игнорируются.
RPC_C_PROFILE_MATCH_BY_IF	Выполняет поиск в профиле элементов, содержащих идентификатор интерфейса, указанный в параметрах IfId и VersOption. Параметр MemberName игнорируется.
RPC_C_PROFILE_MATCH_BY_MBR	Выполняет поиск элементов, содержащих MemberName в профиле. Параметры IfId и VersOption игнорируются.
RPC_C_PROFILE_MATCH_BY_BOTH	Выполняет поиск в профиле элементов, содержащих идентификатор интерфейса и член, определяемый параметрами IfId, VersOption и MemberName .

IfId

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

Параметр IfId используется только при указании значения RPC_C_PROFILE_MATCH_BY_IF или RPC_C_PROFILE_MATCH_BY_BOTH для параметра InquiryType . В противном случае значение IfId игнорируется и можно указать значение NULL.

VersOption

Указывает, как функция RpcNsProfileEltInqNext использует параметр IfId . Этот параметр используется только при указании значения RPC_C_PROFILE_MATCH_BY_IF или RPC_C_PROFILE_MATCH_BY_BOTH в параметре InquiryType. В противном случае этот параметр игнорируется и можно указать значение 0.

В следующей таблице описаны допустимые значения для VersOption.

Значение	Значение
RPC_C_VERS_ALL	Возвращает элементы профиля, которые предлагают указанный UUID интерфейса, независимо от номеров версий. Для этого значения укажите значение 0 как для основной, так и для дополнительных версий в IfId.
RPC_C_VERS_COMPATIBLE	Возвращает элементы профиля, которые предлагают ту же основную версию указанного UUID интерфейса и дополнительную версию, превышающую или равную дополнительной версии указанного интерфейса UUID.
RPC_C_VERS_EXACT	Возвращает элементы профиля, предлагающие указанную версию указанного интерфейса UUID.
RPC_C_VERS_MAJOR_ONLY	Возвращает элементы профиля, которые предлагают ту же основную версию указанного интерфейса UUID (игнорирует дополнительную версию). Для этого значения укажите 0 для дополнительной версии в IfId.
RPC_C_VERS_UPTO	Возвращает элементы профиля, которые предлагают версию указанного UUID интерфейса, которая меньше или равна указанной основной и дополнительной версии. (Например, если IfId содержал версии 2.0, а профиль содержал элементы с версиями 1.3, 2.0 и 2.1, функция RpcNsProfileEltInqNext возвращает элементы с версиями 1.3 и 2.0.)

MemberNameSyntax

Синтаксис MemberName и возвращаемый параметр MemberName в функции RpcNsProfileEltInqNext .

MemberName

Указатель на имя члена, которое функция RpcNsProfileEltInqNext ищет в элементах профиля. Параметр MemberName используется только при указании значения RPC_C_PROFILE_MATCH_BY_MBR или RPC_C_PROFILE_MATCH_BY_BOTH для ЗапросаType. В противном случае MemberName игнорируется и можно указать значение NULL.

InquiryContext

Возвращает указатель на дескриптор службы имен для использования с функциями RpcNsProfileEltInqNext и RpcNsProfileEltInqDone .

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_VERS_OPTION	Недопустимый параметр версии.
RPC_S_INVALID_NAME_SYNTAX	Недопустимый синтаксис имени.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Синтаксис имени не поддерживается.
RPC_S_INCOMPLETE_NAME	Имя является неполным.
RPC_S_ENTRY_NOT_FOUND	Запись name-service не найдена.
RPC_S_NAME_SERVICE_UNAVAILABLE	Служба имен недоступна.

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

Элемент по умолчанию
Все элементы
Элементы с указанным идентификатором интерфейса
Элементы с указанным именем элемента
Элементы с указанным идентификатором интерфейса и именем члена

Перед вызовом RpcNsProfileEltInqNext приложение должно сначала вызвать RpcNsProfileEltInqBegin , чтобы создать контекст запроса.

По завершении просмотра элементов профиля приложение вызывает функцию RpcNsProfileEltInqDone , чтобы удалить контекст запроса.

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

Примечание

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

Требования

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

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

RpcIfInqId

RpcNsProfileEltInqDone

RpcNsProfileEltInqNext

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