EapPeerInvokeIdentityUI-Funktion (eapmethodpeerapis.h)
Löst ein benutzerdefiniertes interaktives Benutzeroberflächendialogfeld aus, um Benutzeridentitätsinformationen für die EAP-Methode auf dem Client abzurufen.
Syntax
DWORD EapPeerInvokeIdentityUI(
[in] EAP_METHOD_TYPE *pEapType,
[in] DWORD dwFlags,
[in] HWND hwndParent,
[in] DWORD dwSizeOfConnectionData,
[in] const BYTE *pConnectionData,
[out] DWORD dwSizeOfUserData,
[in] const BYTE *pUserData,
[out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[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] dwFlags
Eine Kombination von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] hwndParent
Ein Handle für das übergeordnete Fenster, das das interaktive Dialogfeld der Benutzeroberfläche zum Abrufen der Identitätsdaten erzeugt.
[in] dwSizeOfConnectionData
Die Größe der durch pUIContextData angegebenen Benutzeroberflächenkontextdaten in Bytes.
[in] pConnectionData
Ein Zeiger auf einen undurchsichtigen Bytepuffer, der die Verbindungsdaten enthält.
[out] dwSizeOfUserData
Gibt die Größe der in dwSizeOfUserData zurückgegebenen Benutzeridentitätsdaten in Bytes an.
[in] pUserData
Ein Zeiger auf die Benutzerdaten, die für diese Authentifizierung spezifisch sind und zum Vorabfüllen der Benutzerdaten verwendet werden. Wenn diese API zum ersten Mal aufgerufen wird oder eine neue Authentifizierungssitzung gestartet wird, ist dieser Parameter NULL. Legen Sie andernfalls diesen Parameter auf das pUserData-Element der Struktur fest, auf das der ppResult-Parameter verweist, der von EapPeerGetResult empfangen wurde.
[out] pdwSizeOfUserDataOut
Gibt die Größe des ppUserDataOut-Puffers in Bytes an.
[out] ppUserDataOut
Ein Zeiger auf den Zeiger der zurückgegebenen Benutzerdaten. Die Daten werden als Eingabe pUserData an EapPeerBeginSession übergeben.
[out] ppwszIdentity
Ein Zeiger auf die zurückgegebene Benutzeridentität. Der Zeiger wird im Identitätsantwortpaket enthalten und an den Server zurückgegeben.
[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 von EAPHost geladene EAP-Methode implementiert werden und muss den in der Dokumentation angegebenen Syntax- und Parametertypen streng 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 |