Функция EapHostPeerQueryInteractiveUIInputFields (eaphostpeerconfigapis.h)

Статья
08/23/2023

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

Синтаксис

DWORD EapHostPeerQueryInteractiveUIInputFields(
  [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.

Значение	Значение
EAPHOST_PEER_API_VERSION 1	Версия ОДНОрангового API EAPHost.

[in] dwFlags

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

[in] dwSizeofUIContextData

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

[in] pUIContextData

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

[out] pEapInteractiveUIData

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

[out] ppEapError

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

[in, out] ppvReserved

Зарезервировано для последующего использования. Этот параметр должен иметь значение 0.

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

None

Remarks

Для поддержки единого входа можно использовать EapHostPeerQueryInteractiveUIInputFields. Запрашивающий использует флаг EAP_FLAG_PRE_LOGON в EapHostPeerBeginSession , чтобы указать EAPHost, что необходимо предоставить единый вход. Если код действия EapHostPeerResponseInvokeUI получен после вызова EapHostPeerBeginSession, EAPHost затем вызывает EapHostPeerQueryInteractiveUIInputFields, а затем вызывает EapHostPeerQueryUIBlobFromInteractiveUIInputFields.

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

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	eaphostpeerconfigapis.h
Библиотека	Eappcfg.lib
DLL	Eappcfg.dll

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

Функции конфигурации запрашивающего приложения EAPHost

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

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