struttura ONEX_AUTH_PARAMS (dot1x.h)

Articolo
08/23/2023

La struttura ONEX_AUTH_PARAMS contiene 802.1X parametri di autenticazione usati per l'autenticazione 802.1X.

Sintassi

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;

Members

fUpdatePending

Indica se un aggiornamento dello stato è in sospeso per l'autenticazione 802.X.

oneXConnProfile

Profilo di connessione di autenticazione 802.1X. Questo membro contiene una struttura ONEX_CONNECTION_PROFILE incorporata a partire dal membro dwOffset del ONEX_VARIABLE_BLOB.

authIdentity

Identità usata per lo stato di autenticazione 802.1X. Questo membro è un valore dell'enumerazione ONEX_AUTH_IDENTITY .

dwQuarantineState

Valore dello stato di isolamento della quarantena del computer locale. Lo stato di isolamento determina la connettività di rete. Questo membro corrisponde a un valore dell'enumerazione ISOLATION_STATE EAPHost.

fSessionId

Indica se la struttura ONEX_AUTH_PARAMS contiene un ID sessione nel membro dwSessionId .

fhUserToken

Indica se la struttura ONEX_AUTH_PARAMS contiene un handle di token utente nel membro hUserToken .

Per motivi di sicurezza, il membro hUserToken della struttura ONEX_AUTH_PARAMS restituito nel membro authParams della struttura ONEX_RESULT_UPDATE_DATA viene sempre impostato su NULL.

fOnexUserProfile

Indica se la struttura ONEX_AUTH_PARAMS contiene un profilo utente 802.1X nel membro OneXUserProfile .

Per motivi di sicurezza, il membro OneXUserProfile della struttura ONEX_AUTH_PARAMS restituito nel membro authParams della struttura ONEX_RESULT_UPDATE_DATA viene sempre impostato su NULL.

fIdentity

Indica se la struttura ONEX_AUTH_PARAMS contiene un'identità 802.1X nel membro Identity .

fUserName

Indica se la struttura ONEX_AUTH_PARAMS contiene un nome utente utilizzato per l'autenticazione 802.1X nel membro UserName .

fDomain

Indica se la struttura ONEX_AUTH_PARAMS contiene un dominio utilizzato per l'autenticazione 802.1X nel membro Domain .

dwSessionId

ID sessione dell'utente attualmente connesso alla console. Questo membro corrisponde al valore restituito dalla funzione WTSGetActiveConsoleSessionId . Questo membro contiene un ID sessione se è impostato il membro del campo di bit fSessionId .

hUserToken

Handle del token utente usato per l'autenticazione 802.1X. Questo membro contiene un handle di token utente se è impostato il membro del campo di bit fhUserToken .

Per motivi di sicurezza, il membro hUserToken della struttura ONEX_AUTH_PARAMS restituito nel membro authParams della struttura ONEX_RESULT_UPDATE_DATA viene sempre impostato su NULL.

OneXUserProfile

Profilo utente 802.1X usato per l'autenticazione 802.1X. Questo membro contiene un profilo utente incorporato a partire dal membro dwOffset del ONEX_VARIABLE_BLOB se è impostato il membro bitfield fOneXUserProfile .

Identity

Identità 802.1X usata per l'autenticazione 802.1X. Questo membro contiene una stringa Unicode con terminazione NULL con l'identità a partire dal membro dwOffset del ONEX_VARIABLE_BLOB se il membro del campo di bit FIdentity è impostato.

UserName

Nome utente usato per l'autenticazione 802.1X. Questo membro contiene una stringa Unicode con terminazione NULL con il nome utente a partire dal membro dwOffset del ONEX_VARIABLE_BLOB se è impostato il membro del campo di bit fUserName .

Domain

Dominio usato per l'autenticazione 802.1X. Questo membro contiene una stringa Unicode con terminazione NULL con il dominio a partire dal membro dwOffset del ONEX_VARIABLE_BLOB se è impostato il membro del campo di bit fDomain .

Commenti

La struttura ONEX_AUTH_PARAMS viene usata dal modulo 802.1X, un nuovo componente di configurazione wireless supportato in Windows Vista e versioni successive.

Il ONEX_RESULT_UPDATE_DATA contiene informazioni su una modifica dello stato all'autenticazione 802.1X. La struttura ONEX_RESULT_UPDATE_DATA viene restituita quando il membro NotificationSource della struttura WLAN_NOTIFICATION_DATA viene WLAN_NOTIFICATION_SOURCE_ONEX e il membro NotificationCode della struttura WLAN_NOTIFICATION_DATA per la notifica ricevuta è OneXNotificationTypeResultUpdate. Per questa notifica, il membro pData della struttura WLAN_NOTIFICATION_DATA punta a una struttura ONEX_RESULT_UPDATE_DATA che contiene informazioni sulla modifica dello stato di autenticazione 802.1X.

Se il membro fOneXAuthParams nella struttura ONEX_RESULT_UPDATE_DATA è impostato, il membro authParams della struttura ONEX_RESULT_UPDATE_DATA contiene una struttura ONEX_VARIABLE_BLOB con una struttura ONEX_AUTH_PARAMS incorporata a partire dal membro dwOffset del ONEX_VARIABLE_BLOB.

Per motivi di sicurezza, i membri hUserToken e OneXUserProfile della struttura ONEX_AUTH_PARAMS restituiti nel membro authParams vengono sempre impostati su NULL.