EapHostPeerGetAuthStatus, fonction (eappapis.h)

Article
08/23/2023

Obtient le status d’authentification EAP actuel du demandeur auprès d’EAPHost.

Syntaxe

DWORD EapHostPeerGetAuthStatus(
  [in]  EAP_SESSIONID         sessionHandle,
  [in]  EapHostPeerAuthParams authParam,
  [out] DWORD                 *pcbAuthData,
  [out] BYTE                  **ppAuthData,
  [out] EAP_ERROR             **ppEapError
);

Paramètres

[in] sessionHandle

Pointeur vers une structure de EAP_SESSIONID qui contient le handle unique de cette session d’authentification EAP sur le serveur EAPHost. Ce handle est retourné dans le paramètre pSessionId d’un appel précédent à EapHostPeerBeginSession.

[in] authParam

Valeur d’énumération EapHostPeerAuthParams qui spécifie le type de données d’authentification EAP à obtenir à partir d’EAPHost.

Valeur	Signification
EapHostPeerAuthStatus	ppAuthData contient une structure EAPHOST_AUTH_INFO .
EapHostPeerIdentity	ppAuthData contient une mémoire tampon WCHAR .
EapHostPeerIdentityExtendedInfo	ppAuthData contient une mémoire tampon CHAR .
EapHostNapInfo	Windows 7 ou version ultérieure : structure [EapHostPeerNapInfo](/windows/win32/eaphost/eaphostpeernapinfo).

[out] pcbAuthData

Taille, en octets, de la mémoire tampon de données d’authentification EAP pointée vers le paramètre ppAuthData .

[out] ppAuthData

Pointeur vers un pointeur vers une mémoire tampon d’octets qui contient les données d’authentification d’EAPHost. Le format de ces données dépend de la valeur fournie dans authParam.

[out] ppEapError

Pointeur vers l’adresse d’une structure EAP_ERROR . L’adresse doit avoir la valeur NULL avant d’appeler cette fonction. Si des données d’erreur sont disponibles, un pointeur vers l’adresse d’une structure de EAP_ERROR qui contient les erreurs générées pendant l’exécution de cet appel de fonction est reçu. Après avoir utilisé les données d’erreur, libérez cette mémoire en appelant EapHostPeerFreeEapError.

Valeur de retour

None

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	eappapis.h
Bibliothèque	Eappprxy.lib
DLL	Eappprxy.dll

Voir aussi

EAPHost Supplicant Run-Time Functions

Partager via