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