EapHostPeerGetIdentity-Funktion (eappapis.h)
Diese Funktion wird von Tunnelmethoden aufgerufen, um Identitätsinformationen von den inneren Methoden anzufordern. Diese Funktion gibt die Identitäts- und Benutzeranmeldeinformationen zurück.
Syntax
DWORD EapHostPeerGetIdentity(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] EAP_METHOD_TYPE eapMethodType,
[in] DWORD dwSizeofConnectionData,
[in] const BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] const BYTE *pUserData,
[in] HANDLE hTokenImpersonateUser,
[out] BOOL *pfInvokeUI,
[in, out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError,
[in, out] BYTE **ppvReserved
);
Parameter
[in] dwVersion
Die Versionsnummer der API. Muss auf 0 festgelegt werden.
[in] dwFlags
Eine Kombination von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] eapMethodType
Eine EAP_METHOD_TYPE-Struktur , die den Typ der EAP-Authentifizierung angibt, die für diese Sitzung verwendet werden soll.
[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 Authentifizierungssitzung beziehen.
[in] hTokenImpersonateUser
Identitätswechseltoken für einen angemeldeten Benutzer, um benutzerbezogene Informationen zu sammeln.
[out] pfInvokeUI
Gibt TRUE zurück, wenn die Benutzeridentität und das Benutzerdatenblob nicht erfolgreich zurückgegeben werden und die Methode versucht, die Informationen vom Benutzer über das Dialogfeld "Benutzeroberfläche" zu sammeln.
[in, out] pdwSizeOfUserDataOut
Größe des Puffers, der durch den ppUserDataOut-Parameter in Bytes angegeben wird.
[out] ppUserDataOut
Benutzerdateninformationen, die von der -Methode zurückgegeben werden. Nach der Verwendung muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeRuntimeMemory freigegeben werden.
[out] ppwszIdentity
Ein Zeiger auf eine MIT NULL beendete Benutzeridentitätszeichenfolge. Nach der Verwendung muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeRuntimeMemory 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
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eappapis.h |
| Bibliothek | Eappprxy.lib |
| DLL | Eapphost.dll |