estructura de ONEX_CONNECTION_PROFILE
La estructura de ONEX_CONNECTION_PROFILE contiene información sobre el perfil de conexión 802.1X que se usa actualmente para la autenticación 802.1X.
Sintaxis
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;
Miembros
-
dwVersion
-
La versión de esta estructura de ONEX_CONNECTION_PROFILE .
-
dwTotalLen
-
Longitud, en bytes, de esta estructura ONEX_CONNECTION_PROFILE .
-
fOneXSupplicantFlags
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro dwOneXSupplicantFlags .
-
fsupplicantMode
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro supplicantMode .
-
fauthMode
-
Indica si la estructura de ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro authMode .
-
fHeldPeriod
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro dwHeldPeriod .
-
fAuthPeriod
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro dwAuthPeriod .
-
fStartPeriod
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro dwStartPeriod .
-
fMaxStart
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro dwMaxStart .
-
fMaxAuthFailures
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro dwMaxAuthFailures .
-
fNetworkAuthTimeout
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro dwNetworkAuthTimeout .
-
fAllowLogonDialogs
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro bAllowLogonDialogs .
-
fNetworkAuthWithUITimeout
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro dwNetworkAuthWithUITimeout .
-
fUserBasedVLan
-
Indica si la estructura ONEX_CONNECTION_PROFILE contiene datos válidos en el miembro bUserBasedVLan .
-
dwOneXSupplicantFlags
-
Conjunto de marcas 802.1X que pueden estar presentes en el perfil. Estas marcas están reservadas para uso interno del módulo de autenticación 802.1X.
-
supplicantMode
-
El elemento supplicantMode del esquema 802.1X que especifica el método de transmisión utilizado para EAPOL-Start mensajes. Para obtener más información, vea el elemento supplicantMode (OneX) en el esquema 802.1X.
Value Significado - OneXSupplicantModeInhibitTransmission
- 0
EAPOL-Start mensajes no se transmiten. Válido solo para perfiles LAN por cable. - OneXSupplicantModeLearn
- 1
El cliente determina cuándo enviar EAPOL-Start paquetes en función de la funcionalidad de red. EAPOL-Start mensajes solo se envían cuando sea necesario. Válido solo para perfiles LAN por cable. - OneXSupplicantModeCompliant
- 2
EAPOL-Start mensajes se transmiten según lo especificado por 802.1X. Válido tanto para perfiles LAN cableadas como inalámbricos. -
authMode
-
El elemento authMode del esquema 802.1X que especifica el tipo de credenciales usadas para la autenticación 802.1X. Para obtener más información, vea el elemento authMode (OneX) en el esquema 802.1X.
Value Significado - OneXAuthModeMachineOrUser
- 0
Use credenciales de equipo o usuario. Cuando un usuario ha iniciado sesión, las credenciales del usuario se usan para la autenticación. Cuando no se inicia sesión ningún usuario, se usan credenciales de máquina. - OneXAuthModeMachineOnly
- 1
Use solo las credenciales de la máquina. - OneXAuthModeUserOnly
- 2
Use solo las credenciales de usuario. - OneXAuthModeGuest
- 3
Use solo credenciales de invitado (vacío). - OneXAuthModeUnspecified
- 4
No se especifican las credenciales que se van a usar. -
dwHeldPeriod
-
El elemento heldPeriod del esquema 802.1X que especifica el período de tiempo, en segundos, en el que un cliente no volverá a intentar la autenticación después de un intento de autenticación con error. Para obtener más información, vea el elemento heldPeriod (OneX) en el esquema 802.1X.
-
dwAuthPeriod
-
El elemento authPeriod del esquema 802.1X que especifica el período máximo de tiempo, en segundos, en el que un cliente espera una respuesta del autenticador. Si no se recibe una respuesta dentro del período especificado, el cliente asume que no hay ningún autenticador presente en la red. Para obtener más información, vea el elemento authPeriod (OneX) en el esquema 802.1X.
-
dwStartPeriod
-
Elemento startPeriod del esquema 802.1X que especifica el tiempo, en segundos, que se debe esperar antes de enviar un EAPOL-Start. Se envía un mensaje de EAPOL-Start para iniciar el proceso de autenticación 802.1X. Para obtener más información, vea el elemento startPeriod (OneX) en el esquema 802.1X.
-
dwMaxStart
-
El elemento maxStart del esquema 802.1X que especifica el número máximo de mensajes EAPOL-Start enviados. Una vez enviado el número máximo de mensajes de EAPOL-Start, el cliente asume que no hay ningún autenticador presente en la red. Para obtener más información, vea el elemento maxStart (OneX) en el esquema 802.1X.
-
dwMaxAuthFailures
-
El elemento maxAuthFailures del esquema 802.1X que especifica el número máximo de errores de autenticación permitidos para un conjunto de credenciales. Para obtener más información, vea el elemento maxAuthFailures (OneX) en el esquema 802.1X.
-
dwNetworkAuthTimeout
-
El tiempo, en segundos, para esperar la finalización de la autenticación 802.1X antes de que continúe el inicio de sesión normal. Este valor se usa en escenarios de inicio de sesión único (SSO). Este valor tiene como valor predeterminado 10 segundos en un perfil 802.1X. Para obtener más información, vea el elemento maxDelay (singleSignOn) en el esquema 802.1X.
-
dwNetworkAuthWithUITimeout
-
Tiempo máximo de duración, en segundos, para esperar una conexión en caso de que se muestre un cuadro de diálogo de interfaz de usuario que requiere la entrada del usuario durante el inicio de sesión único por inicio de sesión.
En Windows Vista con SP1 y versiones posteriores, este valor se codifica de forma dura en 10 minutos y no se puede configurar. En Windows Vista Release to Manufacturing, este valor tiene como valor predeterminado 60 segundos en un perfil 802.1X y se controló mediante el elemento maxDelayWithAdditionalDialogs en el esquema.
En Windows Vista con SP1 y versiones posteriores, el elemento maxDelayWithAdditionalDialogs del esquema 802.1X se omite y está en desuso.
-
bAllowLogonDialogs
-
Valor que especifica si se van a mostrar diálogos de EAP al usar el inicio de sesión único previo. Para obtener más información, vea el elemento allowAdditionalDialogs en el esquema 802.1X.
-
bUserBasedVLan
-
El elemento userBasedVirtualLan del esquema 802.1X que especifica si la LAN virtual (VLAN) usada por el dispositivo cambia en función de las credenciales del usuario. Algunos dispositivos del servidor de acceso a la red (NAS) cambian la VLAN después de que un usuario se autentique. Cuando userBasedVirtualLan es TRUE, el NAS puede cambiar la VLAN de un dispositivo después de que un usuario se autentique. Para obtener más información, vea el elemento userBasedVirtualLan (singleSignOn) en el esquema 802.1X.
Observaciones
El módulo 802.1X usa la estructura ONEX_CONNECTION_PROFILE , un nuevo componente de configuración inalámbrica compatible con Windows Vista y versiones posteriores.
El ONEX_RESULT_UPDATE_DATA contiene información sobre un cambio de estado a la autenticación 802.1X. La estructura ONEX_RESULT_UPDATE_DATA se devuelve cuando el miembro NotificationSource de la estructura WLAN_NOTIFICATION_DATA está WLAN_NOTIFICATION_SOURCE_ONEX y el miembro NotificationCode de la estructura de WLAN_NOTIFICATION_DATA para la notificación recibida es OneXNotificationTypeResultUpdate. Para esta notificación, el miembro pData de la estructura de WLAN_NOTIFICATION_DATA apunta a una estructura de ONEX_RESULT_UPDATE_DATA que contiene información sobre el cambio de estado de autenticación 802.1X.
Si se establece el miembro fOneXAuthParams de la estructura ONEX_RESULT_UPDATE_DATA , el miembro authParams de la estructura ONEX_RESULT_UPDATE_DATA contiene una estructura de ONEX_VARIABLE_BLOB con una estructura ONEX_AUTH_PARAMS incrustada a partir del miembro dwOffset del ONEX_VARIABLE_BLOB. El miembro oneXConnProfile de la estructura ONEX_AUTH_PARAMS contiene una estructura de ONEX_VARIABLE_BLOB con una estructura ONEX_CONNECTION_PROFILE incrustada a partir del miembro dwOffset del ONEX_VARIABLE_BLOB.
La estructura ONEX_CONNECTION_PROFILE no está definida en un archivo de encabezado público.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
Consulte también