EapHostPeerInvokeIdentityUI-Funktion (eaphostpeerconfigapis.h)
Diese Funktion wird von Tunnelmethoden aufgerufen, um die Identitäts-UI der inneren Methoden aufzurufen. Diese Funktion gibt die Identität sowie Anmeldeinformationen zurück, die zum Starten der Authentifizierung verwendet werden sollen.
Syntax
DWORD EapHostPeerInvokeIdentityUI(
[in] DWORD dwVersion,
[in] EAP_METHOD_TYPE eapMethodType,
[in] DWORD dwFlags,
[in] HWND hwndParent,
[in] DWORD dwSizeofConnectionData,
[in] const BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] const BYTE *pUserData,
[in, out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError,
[in, out] LPVOID *ppvReserved
);
Parameter
[in] dwVersion
Die Versionsnummer der API. Muss auf 0 festgelegt werden.
[in] eapMethodType
Eine EAP_METHOD_TYPE-Struktur , die den Typ der EAP-Authentifizierung angibt, die für diese Sitzung verwendet werden soll.
[in] dwFlags
Eine Kombination von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] hwndParent
Handle des übergeordneten Fensters, in dem das Konfigurationsdialogfeld angezeigt wird.
[in] dwSizeofConnectionData
Größe des Puffers, der durch den pConnectionData-Parameter in Bytes angegeben wird.
[in] pConnectionData
Zeiger auf Konfigurationsdaten, die für die EAP-Methode verwendet werden.
[in] dwSizeofUserData
Größe des Puffers, der durch den pUserData-Parameter in Bytes angegeben wird.
[in] pUserData
Zeiger auf Benutzeranmeldeinformationen, die sich auf diese Authentifizierung beziehen.
[in, out] pdwSizeOfUserDataOut
Größe des Puffersatzes zum Empfangen der Benutzerdaten, die vom ppUserDataOut-Parameter zurückgegeben werden, in Bytes.
[out] ppUserDataOut
Ein Zeiger auf einen Zeiger auf einen Puffer, der von der -Methode zurückgegebene Benutzerdateninformationen enthält. Nach der Verwendung muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeMemory freigegeben werden.
[out] ppwszIdentity
Ein Zeiger auf eine MIT NULL beendete Benutzeridentitätszeichenfolge. Nach der Verwendung 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 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.
Rückgabewert
Keine
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 |