Share via


structure ONEX_CONNECTION_PROFILE

La structure ONEX_CONNECTION_PROFILE contient des informations sur le profil de connexion 802.1X actuellement utilisé pour l’authentification 802.1X.

Syntaxe

typedef struct _ONEX_CONNECTION_PROFILE {
  DWORD                dwVersion;
  DWORD                dwTotalLen;
  DWORD                fOneXSupplicantFlags  :1;
  DWORD                fsupplicantMode  :1;
  DWORD                fauthMode  :1;
  DWORD                fHeldPeriod  :1;
  DWORD                fAuthPeriod  :1;
  DWORD                fStartPeriod  :1;
  DWORD                fMaxStart  :1;
  DWORD                fMaxAuthFailures  :1;
  DWORD                fNetworkAuthTimeout  :1;
  DWORD                fAllowLogonDialogs  :1;
  DWORD                fNetworkAuthWithUITimeout  :1;
  DWORD                fUserBasedVLan  :1;
  DWORD                dwOneXSupplicantFlags;
  ONEX_SUPPLICANT_MODE supplicantMode;
  ONEX_AUTH_MODE       authMode;
  DWORD                dwHeldPeriod;
  DWORD                dwAuthPeriod;
  DWORD                dwStartPeriod;
  DWORD                dwMaxStart;
  DWORD                dwMaxAuthFailures;
  DWORD                dwNetworkAuthTimeout;
  DWORD                dwNetworkAuthWithUITimeout;
  BOOL                 bAllowLogonDialogs;
  BOOL                 bUserBasedVLan;
} ONEX_CONNECTION_PROFILE, *PONEX_CONNECTION_PROFILE;

Membres

dwVersion

Version de cette structure ONEX_CONNECTION_PROFILE .

dwTotalLen

Longueur, en octets, de cette structure ONEX_CONNECTION_PROFILE .

fOneXSupplicantFlags

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre dwOneXSupplicantFlags .

fsupplicantMode

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre supplicantMode .

fauthMode

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre authMode .

fHeldPeriod

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre dwHeldPeriod .

fAuthPeriod

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre dwAuthPeriod .

fStartPeriod

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre dwStartPeriod .

fMaxStart

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre dwMaxStart .

fMaxAuthFailures

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre dwMaxAuthFailures .

fNetworkAuthTimeout

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre dwNetworkAuthTimeout .

fAllowLogonDialogs

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre bAllowLogonDialogs .

fNetworkAuthWithUITimeout

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre dwNetworkAuthWithUITimeout .

fUserBasedVLan

Indique si la structure ONEX_CONNECTION_PROFILE contient des données valides dans le membre bUserBasedVLan .

dwOneXSupplicantFlags

Ensemble d’indicateurs 802.1X qui peuvent être présents dans le profil. Ces indicateurs sont réservés à une utilisation interne par le module d’authentification 802.1X.

supplicantMode

Élément supplicantMode dans le schéma 802.1X qui spécifie la méthode de transmission utilisée pour EAPOL-Start messages. Pour plus d’informations, consultez l’élément supplicantMode (OneX) dans le schéma 802.1X.

Valeur Signification
OneXSupplicantModeInhibitTransmission
0
EAPOL-Start messages ne sont pas transmis. Valide pour les profils LAN câblés uniquement.
OneXSupplicantModeLearn
1
Le client détermine quand envoyer EAPOL-Start paquets en fonction de la capacité réseau. EAPOL-Start messages ne sont envoyés qu’en cas de besoin. Valide pour les profils LAN câblés uniquement.
OneXSupplicantModeCompliant
2
EAPOL-Start messages sont transmis comme spécifié par 802.1X. Valide pour les profils LAN câblés et sans fil.

 

authMode

Élément authMode dans le schéma 802.1X qui spécifie le type d’informations d’identification utilisé pour l’authentification 802.1X. Pour plus d’informations, consultez l’élément authMode (OneX) dans le schéma 802.1X.

Valeur Signification
OneXAuthModeMachineOrUser
0
Utilisez les informations d’identification de l’ordinateur ou de l’utilisateur. Lorsqu’un utilisateur est connecté, ses informations d’identification sont utilisées pour l’authentification. Lorsqu’aucun utilisateur n’est connecté, les informations d’identification de l’ordinateur sont utilisées.
OneXAuthModeMachineOnly
1
Utilisez uniquement les informations d’identification de l’ordinateur.
OneXAuthModeUserOnly
2
Utilisez uniquement les informations d’identification de l’utilisateur.
OneXAuthModeGuest
3
Utilisez uniquement les informations d’identification d’invité (vides).
OneXAuthModeUnspecified
4
Les informations d’identification à utiliser ne sont pas spécifiées.

 

dwHeldPeriod

Élément heldPeriod dans le schéma 802.1X qui spécifie la durée, en secondes, pendant laquelle un client ne tentera pas l’authentification après une tentative d’authentification ayant échoué. Pour plus d’informations, consultez l’élément heldPeriod (OneX) dans le schéma 802.1X.

dwAuthPeriod

Élément authPeriod dans le schéma 802.1X qui spécifie la durée maximale, en secondes, pendant laquelle un client attend une réponse de l’authentificateur. Si aucune réponse n’est reçue dans la période spécifiée, le client suppose qu’il n’y a pas d’authentificateur présent sur le réseau. Pour plus d’informations, consultez l’élément AuthPeriod (OneX) dans le schéma 802.1X.

dwStartPeriod

Élément startPeriod dans le schéma 802.1X qui spécifie la durée, en secondes, d’attente avant l’envoi d’une EAPOL-Start. Un message EAPOL-Start est envoyé pour démarrer le processus d’authentification 802.1X. Pour plus d’informations, consultez l’élément startPeriod (OneX) dans le schéma 802.1X.

dwMaxStart

Élément maxStart dans le schéma 802.1X qui spécifie le nombre maximal de messages EAPOL-Start envoyés. Une fois que le nombre maximal de messages EAPOL-Start a été envoyé, le client suppose qu’aucun authentificateur n’est présent sur le réseau. Pour plus d’informations, consultez l’élément maxStart (OneX) dans le schéma 802.1X.

dwMaxAuthFailures

Élément maxAuthFailures dans le schéma 802.1X qui spécifie le nombre maximal d’échecs d’authentification autorisés pour un ensemble d’informations d’identification. Pour plus d’informations, consultez l’élément maxAuthFailures (OneX) dans le schéma 802.1X.

dwNetworkAuthTimeout

Délai, en secondes, d’attente de la fin de l’authentification 802.1X avant que l’ouverture de session normale ne se poursuive. Cette valeur est utilisée dans les scénarios d’authentification unique (SSO). Cette valeur est par défaut de 10 secondes dans un profil 802.1X. Pour plus d’informations, consultez l’élément maxDelay (singleSignOn) dans le schéma 802.1X.

dwNetworkAuthWithUITimeout

Durée maximale, en secondes, d’attente d’une connexion au cas où une boîte de dialogue d’interface utilisateur nécessitant une entrée utilisateur s’affiche pendant l’authentification unique par ouverture de session.

Sur Windows Vista avec SP1 et versions ultérieures, cette valeur est codée en dur sur 10 minutes et n’est pas configurable. Sur Windows Vista Release to Manufacturing, cette valeur est par défaut de 60 secondes dans un profil 802.1X et a été contrôlée par l’élément maxDelayWithAdditionalDialogs dans le schéma.

Sur Windows Vista avec SP1 et versions ultérieures, l’élément maxDelayWithAdditionalDialogs dans le schéma 802.1X est ignoré et déprécié.

bAllowLogonDialogs

Valeur qui spécifie s’il faut autoriser l’affichage des boîtes de dialogue EAP lors de l’utilisation de l’authentification unique avant l’ouverture de session. Pour plus d’informations, consultez l’élément allowAdditionalDialogs dans le schéma 802.1X.

bUserBasedVLan

Élément userBasedVirtualLan dans le schéma 802.1X qui spécifie si le réseau local virtuel (VLAN) utilisé par l’appareil change en fonction des informations d’identification de l’utilisateur. Certains appareils de serveur d’accès réseau (NAS) modifient le VLAN après l’authentification d’un utilisateur. Lorsque userBasedVirtualLan a la valeur TRUE, le NAS peut modifier le VLAN d’un appareil après l’authentification d’un utilisateur. Pour plus d’informations, consultez l’élément userBasedVirtualLan (singleSignOn) dans le schéma 802.1X.

Notes

La structure ONEX_CONNECTION_PROFILE 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.

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 fOneXAuthParams dans la structure ONEX_RESULT_UPDATE_DATA est défini, le membre authParams de la structure ONEX_RESULT_UPDATE_DATA contient une structure ONEX_VARIABLE_BLOB avec une structure ONEX_AUTH_PARAMS incorporée à partir du membre dwOffset du ONEX_VARIABLE_BLOB. Le membre oneXConnProfile de la structure ONEX_AUTH_PARAMS contient une structure ONEX_VARIABLE_BLOB avec une structure ONEX_CONNECTION_PROFILE incorporée à partir du membre dwOffset du ONEX_VARIABLE_BLOB.

La structure ONEX_CONNECTION_PROFILE n’est pas définie dans un fichier d’en-tête public.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2008 [applications de bureau uniquement]

Voir aussi

À propos de l’architecture ACM

Schéma OneX

élément authMode (OneX)

élément authPeriod (OneX)

élément heldPeriod (OneX)

maxAuthFailures (OneX)

maxStart (OneX) , élément

élément startPeriod (OneX)

élément supplicantMode (OneX)

userBasedVirtualLan (singleSignOn), élément

ONEX_AUTH_PARAMS

ONEX_NOTIFICATION_TYPE

ONEX_RESULT_UPDATE_DATA

OneX Schema, élément

ONEX_VARIABLE_BLOB

WLAN_NOTIFICATION_DATA

WlanRegisterNotification