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

Weitere Informationen

EAPHost Supplicant-Laufzeitfunktionen

EapHostPeerProcessReceivedPacket