EapPeerGetResult-Funktion (eapmethodpeerapis.h)

Ruft das Ergebnis einer Authentifizierungssitzung von der EAP-Methode ab.

Diese Funktion wird aufgerufen, wenn eine Methode die Authentifizierung abgeschlossen hat oder wenn die untere Ebene ein alternatives Ergebnis empfängt.

Syntax

DWORD EapPeerGetResult(
  [in]  EAP_SESSION_HANDLE        sessionHandle,
  [in]  EapPeerMethodResultReason reason,
  [out] EapPeerMethodResult       *ppResult,
  [out] EAP_ERROR                 **ppEapError
);

Parameter

[in] sessionHandle

Ein Zeiger auf eine EAP_SESSION_HANDLE Struktur, die das eindeutige Handle für diese EAP-Authentifizierungssitzung auf dem EAPHost-Server enthält. Dieses Handle wird im pSessionHandle-Parameter in einem vorherigen Aufruf von EapPeerBeginSession zurückgegeben.

[in] reason

Eine EapPeerMethodResultReason-Struktur , die den Ursachencode für das in ppResult zurückgegebene Authentifizierungsergebnis angibt.

[out] ppResult

Ein Zeiger auf eine EapPeerMethodResult-Struktur , die die Authentifizierungsergebnisse enthält.

[out] ppEapError

Ein Zeiger auf die Adresse einer 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 freigegeben werden, indem ein Zeiger auf EapPeerFreeErrorMemory übergeben wird.

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 EAP-Methode implementiert werden, die von EAPHost geladen wird, und sie muss streng den in der Dokumentation angegebenen Syntax- und Parametertypen entsprechen.

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 eapmethodpeerapis.h

Weitere Informationen

EAPHost-Peermethode Run-Time Functions