estructura ONEX_EAP_ERROR (dot1x.h)
La estructura de ONEX_EAP_ERROR contiene el error 802.1X EAP cuando se produce un error con la autenticación 802.1X.
Sintaxis
typedef struct _ONEX_EAP_ERROR {
DWORD dwWinError;
EAP_METHOD_TYPE type;
DWORD dwReasonCode;
GUID rootCauseGuid;
GUID repairGuid;
GUID helpLinkGuid;
DWORD fRootCauseString : 1;
DWORD fRepairString : 1;
ONEX_VARIABLE_BLOB RootCauseString;
ONEX_VARIABLE_BLOB RepairString;
} ONEX_EAP_ERROR, *PONEX_EAP_ERROR;
Miembros
dwWinError
Valor de error definido en el archivo de encabezado Winerror.h . Este miembro también contiene a veces la razón por la que se produjo un error en el método EAP. Los valores existentes para este miembro por el motivo por el que se produjo un error en el método EAP se definen en el archivo de encabezado Eaphosterror.h .
A continuación se enumeran algunos valores posibles.
type
Tipo de método EAP que generó el error durante la autenticación 802.1X. La estructura EAP_METHOD_TYPE se define en el archivo de encabezado Eaptypes.h .
dwReasonCode
Motivo por el que se produjo un error en el método EAP. Algunos de los valores de este miembro se definen en el archivo de encabezado Eaphosterror.h y algunos se definen en el archivo de encabezado Winerror.h , aunque otros valores son posibles.
Los valores posibles se enumeran a continuación.
| Valor | Significado |
|---|---|
|
Uno o más argumentos son incorrectos. |
|
Los datos no son válidos. |
|
Un parámetro es incorrecto. |
|
EAPHost recibió un error de EAP después del intercambio de identidades. Es probable que haya un problema con la cuenta del usuario de autenticación. |
|
Use FormatMessage para obtener la cadena de mensaje para el error devuelto. |
rootCauseGuid
Identificador único que identifica la causa del error en EAPHost. Un método EAP puede definir un nuevo GUID y asociar el GUID a una causa principal específica. Los valores existentes para este miembro se definen en el archivo de encabezado Eaphosterror.h .
repairGuid
Identificador único que se asigna a una cadena localizable que identifica la acción de reparación que se puede realizar para corregir el error notificado. Los valores existentes para este miembro se definen en el archivo de encabezado Eaphosterror.h .
helpLinkGuid
Identificador único que se asigna a una cadena localizable que especifica una dirección URL para una página que contiene información adicional sobre un mensaje de error o reparación. Un método EAP puede definir potencialmente un nuevo GUID y asociarlo a un vínculo de ayuda específico. Algunos de los valores existentes para este miembro se definen en el archivo de encabezado Eaphosterror.h .
fRootCauseString
Indica si la estructura ONEX_EAP_ERROR contiene una cadena de causa principal en el miembro RootCauseString .
fRepairString
Indica si la estructura ONEX_EAP_ERROR contiene una cadena de reparación en el miembro RepairString .
RootCauseString
Cadena localizada y legible que describe la causa principal del error. Este miembro contiene una cadena Unicode terminada en NULL a partir del miembro dwOffset del ONEX_VARIABLE_BLOB si se establece el miembro bitfield fRootCauseString .
RepairString
Cadena localizada y legible que describe la posible acción de reparación. Este miembro contiene una cadena Unicode terminada en NULL a partir del miembro dwOffset del ONEX_VARIABLE_BLOB si se establece el miembro de campo de bits fRepairString .
Comentarios
El módulo 802.1X usa la estructura ONEX_EAP_ERROR , un nuevo componente de configuración inalámbrica compatible con Windows Vista y versiones posteriores.
Muchos miembros de la estructura ONEX_EAP_ERROR corresponden con miembros similares en la estructura EAP_ERROR
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 de WLAN_NOTIFICATION_DATA es 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 fEapError de la estructura ONEX_RESULT_UPDATE_DATA , el miembro eapError de la estructura ONEX_RESULT_UPDATE_DATA contiene una estructura de ONEX_VARIABLE_BLOB con una estructura ONEX_EAP_ERROR incrustada a partir del miembro dwOffset del ONEX_VARIABLE_BLOB.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | dot1x.h |
Consulte también
Acerca de la arquitectura de ACM