EapHostPeerGetAuthStatus-Funktion (eappapis.h)

Artikel
08/23/2023

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.

Wert	Bedeutung
EapHostPeerAuthStatus	ppAuthData enthält eine EAPHOST_AUTH_INFO-Struktur .
EapHostPeerIdentity	ppAuthData enthält einen WCHAR-Puffer .
EapHostPeerIdentityExtendedInfo	ppAuthData enthält einen CHAR-Puffer .
EapHostNapInfo	Windows 7 oder höher: [EapHostPeerNapInfo](/windows/win32/eaphost/eaphostpeernapinfo)-Struktur.

[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


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

Weitere Informationen

EAPHost Supplicant Run-Time Functions

Freigeben über