EapHostPeerInvokeInteractiveUI-Funktion (eaphostpeerconfigapis.h)
Löst eine interaktive Benutzeroberfläche aus, die zum Abrufen von Anmeldeinformationen vom Benutzer verwendet wird. Diese Funktion kann beispielsweise verwendet werden, um eine Benutzeroberfläche auszulösen, die Anmeldeinformationen von einem intelligenten Karte abruft und den Benutzer zur Eingabe der entsprechenden PIN auffordert.
EapHostPeerInvokeInteractiveUI muss für Threads aufgerufen werden, die COM für Single Threaded Apartment initialisiert haben. Dies kann durch Aufrufen der COM-API CoInitialize erreicht werden. wenn der Supplicant mit dem STA-Thread CoUninitialize beendet wurde, muss vor dem Beenden aufgerufen werden.
Syntax
DWORD EapHostPeerInvokeInteractiveUI(
[in] HWND hwndParent,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[out] DWORD *pdwSizeOfDataFromInteractiveUI,
[out] BYTE **ppDataFromInteractiveUI,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] hwndParent
Das Handle des übergeordneten Fensters, unter dem das Konfigurationsdialogfeld angezeigt wird.
[in] dwSizeofUIContextData
Die Größe des Puffers in Bytes, auf den der Parameter pUIContextData verweist.
[in] pUIContextData
Ein Zeiger auf einen Puffer, der die kontextabhängigen Benutzeroberflächenkontextdaten aus EAPHost enthält. Die Kontextdaten werden von EapHostPeerGetUIContext zurückgegeben. Der Puffer hat die Größe dwSizeOfUIContextData.
[out] pdwSizeOfDataFromInteractiveUI
Ein Zeiger auf ein DWORD, das die Größe des Puffers in Bytes darstellt, auf den der ppDataFromInteractiveUI-Parameter verweist.
[out] ppDataFromInteractiveUI
Ein Zeiger auf einen Zeiger auf einen Bytepuffer, der Daten aus der interaktiven Benutzeroberfläche enthält, die für die Authentifizierung erforderlich sind. Der Parameter ppDataFromInteractiveUI sollte als IN-Parameter pUIContext an EapHostPeerSetUIContext übergeben werden. Nach der Nutzung der Daten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeMemory freigegeben werden. Der Puffer hat die Größe pdwSizeofDataFromInteractiveUI.
[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 wurden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeErrorMemory freigegeben werden.
Rückgabewert
Keine
Bemerkungen
Der Supplicant sollte aufrufen, EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED zurückgegeben wird. Der Supplicant sollte auf das herkömmliche Modell des Aufrufens der interaktiven Benutzeroberfläche der Methode zurückgreifen, indem EapHostPeerInvokeInteractiveUI aufgerufen wird.
Wenn der Aufruf erfolgt, löst EapHostPeerInvokeInteractiveUI die Benutzeroberfläche für die EAP-Methode aus, nachdem der supplicant EapHostPeerGetUIContext aufgerufen hat. Dies tritt auf, wenn ein Aufruf von EapHostPeerProcessReceivedPacket den EapHostPeerResponseInvokeUi-Aktionscode zurückgibt. EapHostPeerGetUIContext gibt ui-Kontext zurück, den der Supplicant dann an EapHostPeerInvokeInteractiveUI übergibt, um die Benutzeroberfläche auszulösen.
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 | eaphostpeerconfigapis.h |
| Bibliothek | Eappcfg.lib |
| DLL | Eappcfg.dll |
Weitere Informationen
EAPHost Supplicant-Konfigurationsfunktionen