structure ONEX_AUTH_PARAMS (dot1x.h)

Article
08/23/2023

La structure ONEX_AUTH_PARAMS contient les paramètres d’authentification 802.1X utilisés pour l’authentification 802.1X.

Syntaxe

typedef struct _ONEX_AUTH_PARAMS {
  BOOL               fUpdatePending;
  ONEX_VARIABLE_BLOB oneXConnProfile;
  ONEX_AUTH_IDENTITY authIdentity;
  DWORD              dwQuarantineState;
  DWORD              fSessionId : 1;
  DWORD              fhUserToken : 1;
  DWORD              fOnexUserProfile : 1;
  DWORD              fIdentity : 1;
  DWORD              fUserName : 1;
  DWORD              fDomain : 1;
  DWORD              dwSessionId;
  HANDLE             hUserToken;
  ONEX_VARIABLE_BLOB OneXUserProfile;
  ONEX_VARIABLE_BLOB Identity;
  ONEX_VARIABLE_BLOB UserName;
  ONEX_VARIABLE_BLOB Domain;
} ONEX_AUTH_PARAMS, *PONEX_AUTH_PARAMS;

Membres

fUpdatePending

Indique si une mise à jour status est en attente pour l’authentification 802.X.

oneXConnProfile

Profil de connexion d’authentification 802.1X. Ce membre contient une structure de ONEX_CONNECTION_PROFILE incorporée commençant au membre dwOffset du ONEX_VARIABLE_BLOB.

authIdentity

Identité utilisée pour l’authentification 802.1X status. Ce membre est une valeur de l’énumération ONEX_AUTH_IDENTITY .

dwQuarantineState

Valeur de l’état d’isolation de quarantaine de l’ordinateur local. L’état d’isolation détermine sa connectivité réseau. Ce membre correspond à une valeur de l’énumération ISOLATION_STATE EAPHost.

fSessionId

Indique si la structure ONEX_AUTH_PARAMS contient un ID de session dans le membre dwSessionId .

fhUserToken

Indique si la structure ONEX_AUTH_PARAMS contient un handle de jeton utilisateur dans le membre hUserToken .

Pour des raisons de sécurité, le membre hUserToken de la structure ONEX_AUTH_PARAMS retournée dans le membre authParams de la structure ONEX_RESULT_UPDATE_DATA est toujours défini sur NULL.

fOnexUserProfile

Indique si la structure ONEX_AUTH_PARAMS contient un profil utilisateur 802.1X dans le membre OneXUserProfile .

Pour des raisons de sécurité, le membre OneXUserProfile de la structure ONEX_AUTH_PARAMS retournée dans le membre authParams de la structure ONEX_RESULT_UPDATE_DATA est toujours défini sur NULL.

fIdentity

Indique si la structure ONEX_AUTH_PARAMS contient une identité 802.1X dans le membre Identity .

fUserName

Indique si la structure ONEX_AUTH_PARAMS contient un nom d’utilisateur utilisé pour l’authentification 802.1X dans le membre UserName .

fDomain

Indique si la structure ONEX_AUTH_PARAMS contient un domaine utilisé pour l’authentification 802.1X dans le membre Domain .

dwSessionId

ID de session de l’utilisateur actuellement connecté à la console. Ce membre correspond à la valeur retournée par la fonction WTSGetActiveConsoleSessionId . Ce membre contient un ID de session si le membre de champ de bits fSessionId est défini.

hUserToken

Handle de jeton utilisateur utilisé pour l’authentification 802.1X. Ce membre contient un handle de jeton utilisateur si le membre de champ de bits fhUserToken est défini.

OneXUserProfile

Profil utilisateur 802.1X utilisé pour l’authentification 802.1X. Ce membre contient un profil utilisateur incorporé commençant au membre dwOffset du ONEX_VARIABLE_BLOB si le membre de champ de bits fOneXUserProfile est défini.

Identity

Identité 802.1X utilisée pour l’authentification 802.1X. Ce membre contient une chaîne Unicode terminée par NULL avec l’identité commençant au membre dwOffset du ONEX_VARIABLE_BLOB si le membre du champ de bits fIdentity est défini.

UserName

Nom d’utilisateur utilisé pour l’authentification 802.1X. Ce membre contient une chaîne Unicode terminée par NULL avec le nom d’utilisateur commençant par le membre dwOffset du ONEX_VARIABLE_BLOB si le membre de champ de bits fUserName est défini.

Domain

Domaine utilisé pour l’authentification 802.1X. Ce membre contient une chaîne Unicode terminée par null avec le domaine commençant par le membre dwOffset du ONEX_VARIABLE_BLOB si le membre de champ de bits fDomain est défini.

Notes

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

Pour des raisons de sécurité, les membres hUserToken et OneXUserProfile de la structure ONEX_AUTH_PARAMS retournée dans le membre authParams sont toujours définis sur NULL.

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]
En-tête	dot1x.h