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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eapmethodpeerapis.h |