EapHostPeerGetAuthStatus-Funktion (eappapis.h)

Ruft die aktuelle EAP-Authentifizierungs-status des Supplicants von EAPHost ab.

Syntax

DWORD EapHostPeerGetAuthStatus(
  [in]  EAP_SESSIONID         sessionHandle,
  [in]  EapHostPeerAuthParams authParam,
  [out] DWORD                 *pcbAuthData,
  [out] BYTE                  **ppAuthData,
  [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] authParam

Ein EapHostPeerAuthParams-Enumerationswert , der den Typ der EAP-Authentifizierungsdaten angibt, die von EAPHost abgerufen werden sollen.

[out] pcbAuthData

Die Größe des EAP-Authentifizierungsdatenpuffers in Byte, auf den der ppAuthData-Parameter verweist.

[out] ppAuthData

Ein Zeiger auf einen Zeiger auf einen Bytepuffer, der die Authentifizierungsdaten von EAPHost enthält. Das Format dieser Daten hängt vom in authParam angegebenen Wert ab.

[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. Nachdem Sie die Fehlerdaten verwendet haben, geben Sie diesen Arbeitsspeicher frei, indem Sie EapHostPeerFreeEapError aufrufen.

Rückgabewert

Keine

Anforderungen

Weitere Informationen

EAPHost Supplicant Run-Time Functions