structure ONEX_EAP_ERROR (dot1x.h)
La structure ONEX_EAP_ERROR contient une erreur EAP 802.1X lorsqu’une erreur se produit avec l’authentification 802.1X.
Syntaxe
typedef struct _ONEX_EAP_ERROR {
DWORD dwWinError;
EAP_METHOD_TYPE type;
DWORD dwReasonCode;
GUID rootCauseGuid;
GUID repairGuid;
GUID helpLinkGuid;
DWORD fRootCauseString : 1;
DWORD fRepairString : 1;
ONEX_VARIABLE_BLOB RootCauseString;
ONEX_VARIABLE_BLOB RepairString;
} ONEX_EAP_ERROR, *PONEX_EAP_ERROR;
Membres
dwWinError
Valeur d’erreur définie dans le fichier d’en-tête Winerror.h . Ce membre contient également parfois la raison de l’échec de la méthode EAP. Les valeurs existantes de ce membre pour la raison de l’échec de la méthode EAP sont définies dans le fichier d’en-tête Eaphosterror.h .
Certaines valeurs possibles sont répertoriées ci-dessous.
type
Type de méthode EAP qui a déclenché l’erreur lors de l’authentification 802.1X. La structure EAP_METHOD_TYPE est définie dans le fichier d’en-tête Eaptypes.h .
dwReasonCode
Raison de l’échec de la méthode EAP. Certaines des valeurs de ce membre sont définies dans le fichier d’en-tête Eaphosterror.h et d’autres sont définies dans le fichier d’en-tête Winerror.h , bien que d’autres valeurs soient possibles.
Les valeurs possibles sont répertoriées ci-dessous.
| Valeur | Signification |
|---|---|
|
Un ou plusieurs arguments sont incorrects. |
|
Les données ne sont pas correctes. |
|
Un paramètre est incorrect. |
|
EapHost a reçu un échec EAP après l’échange d’identités. Il y a probablement un problème avec le compte d’authentification de l’utilisateur. |
|
Utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée. |
rootCauseGuid
ID unique qui identifie la cause de l’erreur dans EAPHost. Une méthode EAP peut définir un nouveau GUID et associer le GUID à une cause racine spécifique. Les valeurs existantes pour ce membre sont définies dans le fichier d’en-tête Eaphosterror.h .
repairGuid
ID unique mappé à une chaîne localisable qui identifie l’action de réparation qui peut être effectuée pour corriger l’erreur signalée. Les valeurs existantes de ce membre sont définies dans le fichier d’en-tête Eaphosterror.h .
helpLinkGuid
ID unique mappé à une chaîne localisable qui spécifie une URL pour une page qui contient des informations supplémentaires sur un message d’erreur ou de réparation. Une méthode EAP peut potentiellement définir un nouveau GUID et l’associer à un lien d’aide spécifique. Certaines des valeurs existantes de ce membre sont définies dans le fichier d’en-tête Eaphosterror.h .
fRootCauseString
Indique si la structure ONEX_EAP_ERROR contient une chaîne de cause racine dans le membre RootCauseString .
fRepairString
Indique si la structure ONEX_EAP_ERROR contient une chaîne de réparation dans le membre RepairString .
RootCauseString
Chaîne localisée et lisible qui décrit la cause racine de l’erreur. Ce membre contient une chaîne Unicode terminée par NULL commençant au membre dwOffset du ONEX_VARIABLE_BLOB si le membre de champ de bits fRootCauseString est défini.
RepairString
Chaîne localisée et lisible qui décrit l’action de réparation possible. Ce membre contient une chaîne Unicode terminée par NULL commençant au membre dwOffset du ONEX_VARIABLE_BLOB si le membre de champ de bits fRepairString est défini.
Remarques
La structure ONEX_EAP_ERROR est utilisée par le module 802.1X, un nouveau composant de configuration sans fil pris en charge sur Windows Vista et versions ultérieures.
De nombreux membres de la structure ONEX_EAP_ERROR correspondent à des membres similaires dans la structure EAP_ERROR
Le ONEX_RESULT_UPDATE_DATA contient des informations sur une status passage à l’authentification 802.1X. La structure ONEX_RESULT_UPDATE_DATA est retournée lorsque le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA est WLAN_NOTIFICATION_SOURCE_ONEX et que le membre NotificationCode de la structure WLAN_NOTIFICATION_DATA pour la notification reçue est OneXNotificationTypeResultUpdate. Pour cette notification, le membre pData de la structure WLAN_NOTIFICATION_DATA pointe vers une structure ONEX_RESULT_UPDATE_DATA qui contient des informations sur la modification de la status d’authentification 802.1X.
Si le membre fEapError dans la structure ONEX_RESULT_UPDATE_DATA est défini, le membre eapError de la structure ONEX_RESULT_UPDATE_DATA contient une structure ONEX_VARIABLE_BLOB avec une structure ONEX_EAP_ERROR incorporée à partir du membre dwOffset du ONEX_VARIABLE_BLOB.
Configuration requise
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | dot1x.h |
Voir aussi
À propos de l’architecture ACM