Функция EapPeerQueryCredentialInputFields (eapmethodpeerapis.h)

Статья
08/23/2023

Определяет реализацию функции для конкретного метода EAP, которая получает поля ввода учетных данных единого входа EAP для метода EAP.

Синтаксис

DWORD EapPeerQueryCredentialInputFields(
  [in]  HANDLE                       hUserImpersonationToken,
  [in]  EAP_METHOD_TYPE              eapMethodType,
  [in]  DWORD                        dwFlags,
  [in]  DWORD                        dwEapConnDataSize,
  [in]  BYTE                         *pbEapConnData,
  [out] EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigFieldsArray,
  [out] EAP_ERROR                    **ppEapError
);

Параметры

[in] hUserImpersonationToken

Маркер олицетворения для пользователя, учетные данные которого необходимо запросить и получить.

[in] eapMethodType

Структура EAP_METHOD_TYPE , содержащая сведения о поставщике и авторе о методе EAP, используемом для проверки подлинности подключения.

[in] dwFlags

Сочетание флагов EAP , описывающих поведение сеанса проверки подлинности EAP.

[in] dwEapConnDataSize

Размер байтовых данных конфигурации единого входа EAP, на которые указывает pbEapConnData, в байтах.

[in] pbEapConnData

Указатель на непрозрачный буфер байтов, содержащий большой двоичный объект данных конфигурации EAP.

[out] pEapConfigFieldsArray

Указатель на структуру EAP_CONFIG_INPUT_FIELD_ARRAY , содержащую поля ввода, отображаемые для запрашивающего пользователя. Поля pwszData в отдельных элементах EAP_CONFIG_INPUT_FIELD_DATA инициализируются значением NULL.

[out] ppEapError

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

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

None

Remarks

EapPeerQueryCredentialInputFields поддерживает единый вход. Эта функция однорангового метода, например EapPeerQueryUserBlobFromCredentialInputFields, используется только в сценарии единого входа.

Реализация этой функции для конкретного метода EAP вызывается EAPHost всякий раз, когда запрашивающее приложение вызывает EapHostPeerQueryCredentialInputFields. Разработчик этой функции отвечает за то, чтобы EAP_CONFIG_INPUT_FIELD_ARRAY , возвращаемые этой функцией, содержали определения полей ввода для каждого элемента данных учетных данных, которые методы EAP будут запрашивать у запрашивающего пользователя.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	eapmethodpeerapis.h

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

EAP_CONFIG_INPUT_FIELD_ARRAY

Единый вход и PLAP

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