estrutura ONEX_CONNECTION_PROFILE
A estrutura ONEX_CONNECTION_PROFILE contém informações sobre o perfil de conexão 802.1X usado atualmente para autenticação 802.1X.
Sintaxe
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;
Membros
-
Dwversion
-
A versão dessa estrutura ONEX_CONNECTION_PROFILE .
-
dwTotalLen
-
O comprimento, em bytes, dessa estrutura ONEX_CONNECTION_PROFILE .
-
fOneXSupplicantFlags
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro dwOneXSupplicantFlags .
-
fsupplicantMode
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro supplicantMode .
-
fauthMode
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro authMode .
-
fHeldPeriod
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro dwHeldPeriod .
-
fAuthPeriod
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro dwAuthPeriod .
-
fStartPeriod
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro dwStartPeriod .
-
fMaxStart
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro dwMaxStart .
-
fMaxAuthFailures
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro dwMaxAuthFailures .
-
fNetworkAuthTimeout
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro dwNetworkAuthTimeout .
-
fAllowLogonDialogs
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro bAllowLogonDialogs .
-
fNetworkAuthWithUITimeout
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro dwNetworkAuthWithUITimeout .
-
fUserBasedVLan
-
Indica se a estrutura ONEX_CONNECTION_PROFILE contém dados válidos no membro bUserBasedVLan .
-
dwOneXSupplicantFlags
-
Um conjunto de sinalizadores 802.1X que podem estar presentes no perfil. Esses sinalizadores são reservados para uso interno pelo módulo de autenticação 802.1X.
-
supplicantMode
-
O elemento supplicantMode no esquema 802.1X que especifica o método de transmissão usado para mensagens EAPOL-Start. Para obter mais informações, consulte o elemento supplicantMode (OneX) no esquema 802.1X.
Valor Significado - OneXSupplicantModeInhibitTransmission
- 0
EAPOL-Start mensagens não são transmitidas. Válido somente para perfis lan com fio. - OneXSupplicantModeLearn
- 1
O cliente determina quando enviar EAPOL-Start pacotes com base na funcionalidade de rede. EAPOL-Start mensagens são enviadas somente quando necessário. Válido somente para perfis lan com fio. - OneXSupplicantModeCompliant
- 2
EAPOL-Start mensagens são transmitidas conforme especificado por 802.1X. Válido para perfis lan com e sem fio. -
authMode
-
O elemento authMode no esquema 802.1X que especifica o tipo de credenciais usadas para autenticação 802.1X. Para obter mais informações, consulte o elemento authMode (OneX) no esquema 802.1X.
Valor Significado - OneXAuthModeMachineOrUser
- 0
Use credenciais do computador ou do usuário. Quando um usuário está conectado, as credenciais do usuário são usadas para autenticação. Quando nenhum usuário está conectado, as credenciais do computador são usadas. - OneXAuthModeMachineOnly
- 1
Use apenas credenciais de computador. - OneXAuthModeUserOnly
- 2
Use apenas credenciais de usuário. - OneXAuthModeGuest
- 3
Use apenas credenciais de convidado (vazias). - OneXAuthModeUnspecified
- 4
As credenciais a serem usadas não são especificadas. -
dwHeldPeriod
-
O elemento heldPeriod no esquema 802.1X que especifica o período de tempo, em segundos, em que um cliente não tentará novamente a autenticação após uma tentativa de autenticação com falha. Para obter mais informações, consulte o elemento heldPeriod (OneX) no esquema 802.1X.
-
dwAuthPeriod
-
O elemento authPeriod no esquema 802.1X que especifica o período máximo de tempo, em segundos, em que um cliente aguarda uma resposta do autenticador. Se uma resposta não for recebida dentro do período especificado, o cliente assumirá que não há nenhum autenticador presente na rede. Para obter mais informações, consulte o elemento authPeriod (OneX) no esquema 802.1X.
-
dwStartPeriod
-
O elemento startPeriod no esquema 802.1X que especifica o período de tempo, em segundos, para aguardar antes que um EAPOL-Start seja enviado. Uma mensagem EAPOL-Start é enviada para iniciar o processo de autenticação 802.1X. Para obter mais informações, consulte o elemento startPeriod (OneX) no esquema 802.1X.
-
dwMaxStart
-
O elemento maxStart no esquema 802.1X que especifica o número máximo de mensagens EAPOL-Start enviadas. Depois que o número máximo de mensagens EAPOL-Start tiver sido enviado, o cliente pressupõe que não há nenhum autenticador presente na rede. Para obter mais informações, consulte o elemento maxStart (OneX) no esquema 802.1X.
-
dwMaxAuthFailures
-
O elemento maxAuthFailures no esquema 802.1X que especifica o número máximo de falhas de autenticação permitidas para um conjunto de credenciais. Para obter mais informações, consulte o elemento maxAuthFailures (OneX) no esquema 802.1X.
-
dwNetworkAuthTimeout
-
O tempo, em segundos, para aguardar a conclusão da autenticação 802.1X antes que o logon normal continue. Esse valor é usado em cenários de SSO (logon único). Esse valor assume como padrão 10 segundos em um perfil 802.1X. Para obter mais informações, consulte o Elemento maxDelay (singleSignOn) no esquema 802.1X.
-
dwNetworkAuthWithUITimeout
-
O tempo máximo de duração, em segundos, para aguardar uma conexão caso uma caixa de diálogo de interface do usuário que exija a entrada do usuário seja exibida durante o SSO por logon.
No Windows Vista com SP1 e posterior, esse valor é codificado para 10 minutos e não é configurável. No Windows Vista Release to Manufacturing, esse valor usa como padrão 60 segundos em um perfil 802.1X e foi controlado pelo elemento maxDelayWithAdditionalDialogs no esquema.
No Windows Vista com SP1 e posterior, o elemento maxDelayWithAdditionalDialogs no esquema 802.1X é ignorado e preterido.
-
bAllowLogonDialogs
-
Um valor que especifica se as caixas de diálogo EAP devem ser exibidas ao usar o SSO de pré-logon. Para obter mais informações, consulte o elemento allowAdditionalDialogs no esquema 802.1X.
-
bUserBasedVLan
-
O elemento userBasedVirtualLan no esquema 802.1X que especifica se a LAN virtual (VLAN) usada pelo dispositivo é alterada com base nas credenciais do usuário. Alguns dispositivos NAS (servidor de acesso à rede) alteram a VLAN após a autenticação de um usuário. Quando userBasedVirtualLan é TRUE, o NAS pode alterar a VLAN de um dispositivo após a autenticação de um usuário. Para obter mais informações, consulte o Elemento userBasedVirtualLan (singleSignOn) no esquema 802.1X.
Comentários
A estrutura ONEX_CONNECTION_PROFILE é usada pelo módulo 802.1X, um novo componente de configuração sem fio com suporte no Windows Vista e posterior.
O ONEX_RESULT_UPDATE_DATA contém informações sobre uma status alteração para autenticação 802.1X. A estrutura ONEX_RESULT_UPDATE_DATA é retornada quando o membro NotificationSource da estrutura WLAN_NOTIFICATION_DATA é WLAN_NOTIFICATION_SOURCE_ONEX e o membro NotificationCode da estrutura WLAN_NOTIFICATION_DATA para notificação recebida é OneXNotificationTypeResultUpdate. Para essa notificação, o membro pData da estrutura WLAN_NOTIFICATION_DATA aponta para uma estrutura ONEX_RESULT_UPDATE_DATA que contém informações sobre a alteração de status de autenticação 802.1X.
Se o membro fOneXAuthParams na estrutura ONEX_RESULT_UPDATE_DATA estiver definido, o membro authParams da estrutura ONEX_RESULT_UPDATE_DATA conterá uma estrutura ONEX_VARIABLE_BLOB com uma estrutura ONEX_AUTH_PARAMS inserida começando no membro dwOffset do ONEX_VARIABLE_BLOB. O membro oneXConnProfile da estrutura ONEX_AUTH_PARAMS contém uma estrutura ONEX_VARIABLE_BLOB com uma estrutura ONEX_CONNECTION_PROFILE inserida começando no membro dwOffset do ONEX_VARIABLE_BLOB.
A estrutura ONEX_CONNECTION_PROFILE não é definida em um arquivo de cabeçalho público.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
Confira também