EapHostPeerGetResult-Funktion (eappapis.h)
Ruft das Authentifizierungsergebnis für die angegebene EAP-Authentifizierungssitzung ab.
Syntax
DWORD EapHostPeerGetResult(
[in] EAP_SESSIONID sessionHandle,
[in] EapHostPeerMethodResultReason reason,
[out] EapHostPeerMethodResult *ppResult,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] sessionHandle
Ein Zeiger auf eine EAP_SESSIONID Struktur, die das eindeutige Handle für diese EAP-Authentifizierungssitzung auf dem EAPHost-Server enthält. Dieses Handle wird im pSessionId-Parameter in einem vorherigen Aufruf von EapHostPeerBeginSession zurückgegeben.
[in] reason
Ein EapHostPeerMethodResultReason-Enumerationswert , der den Ursachencode für das in ppResult zurückgegebene Authentifizierungsergebnis angibt.
[out] ppResult
Ein Zeiger auf eine EapHostPeerMethodResultReason-Struktur , die die Authentifizierungsergebnisse enthält. EAPHost füllt diese Struktur mit Authentifizierungsinformationen aus, die in EapHostPeerMethodResult definiert sind.
[out] ppEapError
Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur . Die Adresse sollte vor dem Aufrufen dieser Funktion auf NULL festgelegt werden. Wenn Fehlerdaten verfügbar sind, wird ein Zeiger auf die Adresse einer EAP_ERROR-Struktur empfangen, die alle Fehler enthält, die während der Ausführung dieses Funktionsaufrufs ausgelöst wurden. Supplicants müssen auf diesen Parameter verweisen, um zu bestimmen, ob die Authentifizierung erfolgreich war. Nachdem Sie die Fehlerdaten verwendet haben, geben Sie diesen Arbeitsspeicher frei, indem Sie EapHostPeerFreeEapError aufrufen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR. Der Rückgabewert gibt nicht an, ob die Authentifizierung erfolgreich war. Supplicants müssen auf den ppEapError-Parameter verweisen, um das Authentifizierungsergebnis zu bestimmen.
Wenn die Funktion fehlschlägt, sollte der Rückgabewert ein geeigneter Fehlercode von Winerror.h, Raserror.h oder Mprerror.h sein.
Hinweise
Der Supplicant ruft EapHostPeerGetResult nach Abschluss einer Authentifizierung auf, die in einem der folgenden Szenarien auftreten kann.
- Ein Aufruf von EapHostPeerProcessReceivedPacket hat den EapHostPeerResponseResult-Aktionscode zurückgegeben.
- Der Client hat ein Timeout ausgeführt und möchte das Ergebnis basierend auf dem aktuellen Zustand abrufen.
- Der Supplicant hat ein alternatives Ergebnis erhalten, vielleicht von einem Paket auf der unteren Ebene.
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 | eappapis.h |
| Bibliothek | Eappprxy.lib |
| DLL | Eappprxy.dll |