EapPeerGetIdentity-Funktion (eapmethodpeerapis.h)
Gibt die Benutzerdaten und die Benutzeridentität zurück, nachdem sie von EAPHost aufgerufen wurden.
Syntax
DWORD EapPeerGetIdentity(
[in] DWORD dwFlags,
[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
);
Parameter
[in] dwFlags
Eine Kombination von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] dwSizeofConnectionData
Gibt die Größe des In pConnectionData bereitgestellten Verbindungsdatenpuffers in Bytes an.
[in] pConnectionData
Ein Zeiger auf einen Bytepuffer, der das undurchsichtige Konfigurationsdatenblob enthält.
[in] dwSizeofUserData
Gibt die Größe des in pUserData bereitgestellten Benutzerdatenpuffers 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.
[in] hTokenImpersonateUser
Gibt ein Handle für das Identitätswechseltoken des authentifizierten Benutzers an. Dieses Handle ist NULL , wenn die Computerauthentifizierung ausgeführt wird. Mithilfe dieses Handles kann eine EAP-Methode die Identität des Benutzers annehmen, um benutzerspezifische Informationen wie Benutzername, Domänenname und Anmeldeinformationen abzurufen.
[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
Gibt die Größe des ppUserDataOut-Puffers in Bytes an.
[out] ppUserDataOut
Ein Zeiger auf einen Zeiger auf die 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 den Zeiger auf eine 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 |