EapHostPeerInvokeConfigUI-Funktion (eaphostpeerconfigapis.h)
Startet die Konfigurations-Benutzeroberfläche der angegebenen EAP-Methode.
EapHostPeerInvokeConfigUI muss für Threads aufgerufen werden, die COM für Single Threaded Apartment (STA) initialisiert haben. Dies kann durch Aufrufen der COM-API CoInitialize erreicht werden. wenn der Supplicant mit dem STA-Thread CoUninitialize beendet hat, muss vor dem Beenden aufgerufen werden.
Syntax
DWORD EapHostPeerInvokeConfigUI(
[in] HWND hwndParent,
[in] DWORD dwFlags,
[in] EAP_METHOD_TYPE eapMethodType,
[in] DWORD dwSizeOfConfigIn,
[in] const BYTE *pConfigIn,
[out] DWORD *pdwSizeOfConfigOut,
[out] BYTE **ppConfigOut,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] hwndParent
Das Handle des übergeordneten Fensters, unter dem das Konfigurationsdialogfeld angezeigt wird.
[in] dwFlags
Eine Kombination von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] eapMethodType
Eine EAP_METHOD_TYPE-Struktur , die die EAP-Methode angibt.
[in] dwSizeOfConfigIn
Die Größe der Eingabekonfiguration. Kann auf 0 (null) festgelegt werden.
[in] pConfigIn
Ein Zeiger auf einen Bytepuffer, der Konfigurationselemente enthält. Der Puffer hat die Größe dwSizeOfConfigIn. Dieser Parameter kann NULL sein, wenn dwSizeOfConfigIn auf 0 (null) festgelegt ist.
[out] pdwSizeOfConfigOut
Ein Zeiger auf ein DWORD, das die Größe des Puffers angibt, auf den ppConfigOut verweist.
[out] ppConfigOut
Ein Zeiger auf einen Zeiger auf einen Bytepuffer, der aktualisierte Konfigurationsdaten des Benutzers enthält. Nach dem Verbrauch der Daten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeMemory freigegeben werden.
[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.
Rückgabewert
Keine
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 |