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

Статья
08/23/2023

Функция EapPeerQueryInteractiveUIInputFields определяет реализацию API метода EAP, который предоставляет поля ввода для интерактивных компонентов пользовательского интерфейса, которые будут вызываться в запрашиваемом объекте.

Синтаксис

DWORD EapPeerQueryInteractiveUIInputFields(
  [in]      DWORD                   dwVersion,
  [in]      DWORD                   dwFlags,
  [in]      DWORD                   dwSizeofUIContextData,
  [in]      const BYTE              *pUIContextData,
  [out]     EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [out]     EAP_ERROR               **ppEapError,
  [in, out] LPVOID                  *ppvReserved
);

Параметры

[in] dwVersion

Номер версии API. Необходимо задать нулевое значение.

[in] dwFlags

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

[in] dwSizeofUIContextData

Размер контекстных данных в pUIContextData в байтах.

[in] pUIContextData

Указатель на большой двоичный объект, содержащий данные контекста пользовательского интерфейса, представленный в виде внутренних указателей на данные поля. Запрашивающий получил эти внутренние указатели из API среды выполнения EAPHost.

[out] pEapInteractiveUIData

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

[out] ppEapError

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

[in, out] ppvReserved

Зарезервировано для использования в будущем. Должен иметь значение NULL.

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

None

Remarks

Для поддержки единого входа (SSO) можно использовать EapPeerQueryInteractiveUIInputFields. Флаг EAP_FLAG_PRE_LOGON в EapPeerBeginSession указывает EAPHost, что необходимо предоставить единый вход. Если код действия EapPeerResponseInvokeUI получен после вызова EapPeerBeginSession, EAPHost вызывает EapPeerQueryInteractiveUIInputFields, а затем вызывает EapPeerQueryUIBlobFromInteractiveUIInputFields.

Запрашивающий должен вызывать всегда вызов EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED возвращается, а запрашивающий должен прибегнуть к традиционной модели вызова интерактивного пользовательского интерфейса метода путем вызова EapPeerInvokeInteractiveUI. При возникновении ошибки EapPeerQueryInteractiveUIInputFields вернет код возврата, отличный от NULL.

Требования

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

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

EAP_CONFIG_INPUT_FIELD_ARRAY

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

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