EapHostPeerQueryInteractiveUIInputFields-Funktion (eaphostpeerconfigapis.h)
Die EapHostPeerQueryInteractiveUIInputFields-Funktion ruft die Eingabefelder für interaktive UI-Komponenten ab, die auf dem Supplicant ausgelöst werden sollen.
Syntax
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
);
Parameter
[in] dwVersion
Die Versionsnummer der API.
| Wert | Bedeutung |
|---|---|
|
Die Version der EAPHost-Peer-API. |
[in] dwFlags
Eine Kombination von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] dwSizeofUIContextData
Die Größe der Kontextdaten in pUIContextData in Bytes.
[in] pUIContextData
Zeiger auf ein BLOB, das Benutzeroberflächenkontextdaten enthält, die als innere Zeiger auf Felddaten dargestellt werden. Diese inneren Zeiger müssen freigegeben werden, indem sie an EapHostPeerFreeMemory übergeben werden, beginnend mit dem innersten Zeiger.
[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. Der Aufrufer sollte die inneren Zeiger mit der Funktion EapHostPeerFreeMemory freigeben, beginnend mit dem innersten Zeiger.
[out] ppEapError
Ein Zeiger auf einen Zeiger auf eine EAP_ERROR-Struktur , die alle Fehler enthält, die von EAPHost während der Ausführung dieses Funktionsaufrufs ausgelöst werden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeErrorMemory freigegeben werden.
[in, out] ppvReserved
Für die zukünftige Verwendung reserviert. Dieser Parameter muss auf 0 festgelegt werden.
Rückgabewert
Keine
Bemerkungen
EapHostPeerQueryInteractiveUIInputFields kann verwendet werden, um einmaliges Anmelden (Single Sign-On, SSO) zu unterstützen. Das Supplicant verwendet das EAP_FLAG_PRE_LOGON-Flag in EapHostPeerBeginSession , um EAPHost anzugeben, dass einmaliges Anmelden bereitgestellt werden soll. Wenn der EapHostPeerResponseInvokeUI-Aktionscode nach dem Aufruf von EapHostPeerBeginSession empfangen wird, ruft EAPHostPeerQueryInteractiveUIInputFields und später EapHostPeerQueryUIBlobFromInteractiveUIInputFields auf.
Der Supplicant sollte die EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED zurückgegeben wird, der Supplicant sollte auf das herkömmliche Modell der interaktiven Benutzeroberfläche der Aufrufmethode zurückgreifen, indem EapHostPeerInvokeInteractiveUI aufgerufen wird. Wenn ein Fehler auftritt, gibt EapHostPeerQueryInteractiveUIInputFields einen anderen Rückgabecode als NULL zurück.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eaphostpeerconfigapis.h |
| Bibliothek | Eappcfg.lib |
| DLL | Eappcfg.dll |