struttura ONEX_CONNECTION_PROFILE
La struttura ONEX_CONNECTION_PROFILE contiene informazioni sul profilo di connessione 802.1X attualmente usato per l'autenticazione 802.1X.
Sintassi
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;
Members
-
dwVersion
-
Versione di questa struttura ONEX_CONNECTION_PROFILE .
-
dwTotalLen
-
Lunghezza, in byte, di questa struttura ONEX_CONNECTION_PROFILE .
-
fOneXSupplicantFlags
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro dwOneXSupplicantFlags .
-
fsupplicantMode
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro supplicantMode .
-
fauthMode
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro authMode .
-
fHeldPeriod
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro dwHeldPeriod .
-
fAuthPeriod
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro dwAuthPeriod .
-
fStartPeriod
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro dwStartPeriod .
-
fMaxStart
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro dwMaxStart .
-
fMaxAuthFailures
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro dwMaxAuthFailures .
-
fNetworkAuthTimeout
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro dwNetworkAuthTimeout .
-
fAllowLogonDialogs
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro bAllowLogonDialogs .
-
fNetworkAuthWithUITimeout
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro dwNetworkAuthWithUITimeout .
-
fUserBasedVLan
-
Indica se la struttura ONEX_CONNECTION_PROFILE contiene dati validi nel membro bUserBasedVLan .
-
dwOneXSupplicantFlags
-
Set di flag 802.1X che possono essere presenti nel profilo. Questi flag sono riservati per l'uso interno del modulo di autenticazione 802.1X.
-
supplicantMode
-
Elemento supplicantMode nello schema 802.1X che specifica il metodo di trasmissione utilizzato per EAPOL-Start messaggi. Per altre informazioni, vedere l'elemento supplicantMode (OneX) nello schema 802.1X.
Valore Significato - OneXSupplicantModeInhibitTransmission
- 0
EAPOL-Start i messaggi non vengono trasmessi. Valido solo per i profili LAN cablati. - OneXSupplicantModeLearn
- 1
Il client determina quando inviare pacchetti EAPOL-Start in base alla funzionalità di rete. EAPOL-Start i messaggi vengono inviati solo quando necessario. Valido solo per i profili LAN cablati. - OneXSupplicantModeCompliant
- 2
EAPOL-Start messaggi vengono trasmessi come specificato da 802.1X. Valido sia per i profili LAN cablati che per i profili LAN wireless. -
Authmode
-
Elemento authMode nello schema 802.1X che specifica il tipo di credenziali usate per l'autenticazione 802.1X. Per altre informazioni, vedere l'elemento authMode (OneX) nello schema 802.1X.
Valore Significato - OneXAuthModeMachineOrUser
- 0
Usare le credenziali del computer o dell'utente. Quando un utente è connesso, le credenziali dell'utente vengono usate per l'autenticazione. Quando nessun utente è connesso, vengono usate le credenziali del computer. - OneXAuthModeMachineOnly
- 1
Usare solo le credenziali del computer. - OneXAuthModeUserOnly
- 2
Usare solo le credenziali utente. - OneXAuthModeGuest
- 3
Usare solo le credenziali guest (vuote). - OneXAuthModeUnspecified
- 4
Le credenziali da utilizzare non sono specificate. -
dwHeldPeriod
-
Elemento heldPeriod nello schema 802.1X che specifica il periodo di tempo, in secondi, in cui un client non tenterà nuovamente l'autenticazione dopo un tentativo di autenticazione non riuscito. Per altre informazioni, vedere l'elemento heldPeriod (OneX) nello schema 802.1X.
-
dwAuthPeriod
-
Elemento authPeriod nello schema 802.1X che specifica la durata massima, in secondi, in cui un client attende una risposta dall'autenticatore. Se una risposta non viene ricevuta entro il periodo specificato, il client presuppone che nella rete non sia presente alcun autenticatore. Per altre informazioni, vedere l'elemento authPeriod (OneX) nello schema 802.1X.
-
dwStartPeriod
-
Elemento startPeriod nello schema 802.1X che specifica la durata, in secondi, di attesa prima dell'invio di un EAPOL-Start. Viene inviato un messaggio EAPOL-Start per avviare il processo di autenticazione 802.1X. Per altre informazioni, vedere l'elemento startPeriod (OneX) nello schema 802.1X.
-
dwMaxStart
-
Elemento maxStart nello schema 802.1X che specifica il numero massimo di messaggi EAPOL-Start inviati. Dopo l'invio del numero massimo di messaggi EAPOL-Start, il client presuppone che nella rete non sia presente alcun autenticatore. Per altre informazioni, vedere l'elemento maxStart (OneX) nello schema 802.1X.
-
dwMaxAuthFailures
-
L'elemento maxAuthFailures nello schema 802.1X che specifica il numero massimo di errori di autenticazione consentiti per un set di credenziali. Per altre informazioni, vedere l'elemento maxAuthFailures (OneX) nello schema 802.1X.
-
dwNetworkAuthTimeout
-
Tempo, espresso in secondi, per attendere il completamento dell'autenticazione 802.1X prima del normale completamento dell'accesso. Questo valore viene usato in singoli scenari signon (SSO). Il valore predefinito è 10 secondi in un profilo 802.1X. Per altre informazioni, vedere l'elemento maxDelay (singleSignOn) nello schema 802.1X.
-
dwNetworkAuthWithUITimeout
-
Tempo massimo di attesa, in secondi, per una connessione nel caso in cui venga visualizzata una finestra di dialogo dell'interfaccia utente che richiede l'input dell'utente durante l'accesso SSO per accesso.
In Windows Vista con SP1 e versioni successive questo valore è hardcoded a 10 minuti e non è configurabile. In Windows Vista Release to Manufacturing, il valore predefinito è 60 secondi in un profilo 802.1X ed è stato controllato dall'elemento maxDelayWithAdditionalDialogs nello schema.
In Windows Vista con SP1 e versioni successive l'elemento maxDelayWithAdditionalDialogs nello schema 802.1X viene ignorato e deprecato.
-
bAllowLogonDialogs
-
Valore che specifica se consentire la visualizzazione delle finestre di dialogo EAP quando si usa l'accesso SSO pre-accesso. Per altre informazioni, vedere l'elemento allowAdditionalDialogs nello schema 802.1X.
-
bUserBasedVLan
-
Elemento userBasedVirtualLan nello schema 802.1X che specifica se la LAN virtuale (VLAN) usata dal dispositivo cambia in base alle credenziali dell'utente. Alcuni dispositivi NAS (Network Access Server) modificano la VLAN dopo l'autenticazione di un utente. Quando userBasedVirtualLan è TRUE, il NAS può modificare la VLAN di un dispositivo dopo l'autenticazione di un utente. Per altre informazioni, vedere l'elemento userBasedVirtualLan (singleSignOn) nello schema 802.1X.
Commenti
La struttura ONEX_CONNECTION_PROFILE 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. Il membro oneXConnProfile della struttura ONEX_AUTH_PARAMS contiene una struttura ONEX_VARIABLE_BLOB con una struttura ONEX_CONNECTION_PROFILE incorporata a partire dal membro dwOffset del ONEX_VARIABLE_BLOB.
La struttura ONEX_CONNECTION_PROFILE non è definita in un file di intestazione pubblica.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 [solo app desktop] |
Vedi anche