EapPeerQueryInteractiveUIInputFields-Funktion (eapmethodpeerapis.h)

Die EapPeerQueryInteractiveUIInputFields-Funktion definiert die Implementierung einer EAP-Methoden-API, die die Eingabefelder für interaktive UI-Komponenten bereitstellt, die auf dem Supplicant ausgelöst werden sollen.

Syntax

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
);

Parameter

[in] dwVersion

Die Versionsnummer der API. Muss auf 0 (null) festgelegt werden.

[in] dwFlags

Eine Kombination aus EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.

[in] dwSizeofUIContextData

Die Größe der Kontextdaten in pUIContextData in Bytes.

[in] pUIContextData

Ein Zeiger auf ein BLOB, das Benutzeroberflächenkontextdaten enthält, die als innere Zeiger auf Felddaten dargestellt werden. Der Supplicant hat diese inneren Zeiger von EAPHost-Laufzeit-APIs abgerufen.

[out] pEapInteractiveUIData

Zeiger, der eine EAP_INTERACTIVE_UI_DATA-Struktur empfängt, die Konfigurationsinformationen für interaktive UI-Komponenten enthält, die auf einem EAP-Supplicant ausgelöst werden.

[out] ppEapError

Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur , die alle Fehler enthält, die während der Ausführung dieses Funktionsaufrufs ausgelöst wurden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem ein Zeiger auf die Fehlerdaten an EapPeerFreeErrorMemory übergeben wird.

[in, out] ppvReserved

Zur künftigen Verwendung reserviert. Muss auf NULL festgelegt werden.

Rückgabewert

Keine

Bemerkungen

EapPeerQueryInteractiveUIInputFields kann zur Unterstützung des einmaligen Anmeldens (Single Sign-On, SSO) verwendet werden. Das EAP_FLAG_PRE_LOGON-Flag in EapPeerBeginSession gibt EAPHost an, dass einmaliges Anmelden bereitgestellt werden soll. Wenn der EapPeerResponseInvokeUI-Aktionscode nach dem Aufruf von EapPeerBeginSession empfangen wird, ruft EAPHost dann EapPeerQueryInteractiveUIInputFields und später EapPeerQueryUIBlobFromInteractiveUIInputFields auf.

Der Supplicant sollte immer die EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED zurückgegeben wird aufrufen, der Supplicant sollte auf das herkömmliche Modell des Aufrufens der interaktiven Benutzeroberfläche der Methode zurückgreifen, indem EapPeerInvokeInteractiveUI aufgerufen wird. Wenn ein Fehler auftritt, gibt EapPeerQueryInteractiveUIInputFields einen anderen Rückgabecode als NULL zurück.

Anforderungen

Weitere Informationen

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO und PLAP