EapPeerInvokeConfigUI-Funktion (eapmethodpeerapis.h)
Löst auf dem Client das Dialogfeld für die spezifische Verbindungskonfiguration der EAP-Methode aus.
Syntax
DWORD EapPeerInvokeConfigUI(
[in] EAP_METHOD_TYPE *pEapType,
[in] HWND hwndParent,
[in] DWORD dwFlags,
[in] DWORD dwSizeOfConnectionDataIn,
[in] BYTE *pConnectionDataIn,
[out] DWORD *pdwSizeOfConnectionDataOut,
[out] BYTE **ppConnectionDataOut,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] pEapType
Eine EAP_METHOD_TYPE Struktur, die Anbieter- und Autoreninformationen zur EAP-Methode enthält, die für die Authentifizierung der Verbindung verwendet wird.
[in] hwndParent
Ein Handle für das übergeordnete Fenster, das das Dialogfeld für die Benutzeroberfläche der Verbindungskonfiguration erzeugt.
[in] dwFlags
Eine Kombination aus EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] dwSizeOfConnectionDataIn
Gibt die Größe des pConnectionDataIn-Puffers in Bytes an.
[in] pConnectionDataIn
Ein Zeiger auf die Für diese Authentifizierung spezifischen Verbindungsdaten, die zum Vorabfüllen der Konfigurationsbenutzeroberfläche verwendet werden. Wenn diese API zum ersten Mal aufgerufen wird oder eine neue Authentifizierungssitzung gestartet wird, ist dieser Parameter NULL.
[out] pdwSizeOfConnectionDataOut
Empfängt einen Zeiger auf die Größe des ppConnectionDataOut-Parameters in Byte.
[out] ppConnectionDataOut
Empfängt einen Zeiger auf einen Zeiger, der einen Bytepuffer mit den vom Benutzer konfigurierten Verbindungsdaten enthält.
[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 durch Aufrufen von EapPeerFreeErrorMemory freigegeben werden.
Rückgabewert
Keine
Bemerkungen
Dieser Aufruf wird von einem peerbasierten EAPHost mit einem Funktionszeiger auf diese API ausgeführt. Diese API muss für die EAP-Methode implementiert werden, die von EAPHost geladen wird, und sie muss streng den in der Dokumentation angegebenen Syntax- und Parametertypen entsprechen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eapmethodpeerapis.h |