структура ONEX_EAP_ERROR (dot1x.h)
Структура ONEX_EAP_ERROR содержит ошибку EAP 802.1X при возникновении ошибки при проверке подлинности 802.1X.
Синтаксис
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;
Члены
dwWinError
Значение ошибки, определенное в файле заголовка Winerror.h . Этот элемент также иногда содержит причину сбоя метода EAP. Существующие значения для этого элемента по причине сбоя метода EAP определяются в файле заголовка Eaphosterror.h .
Ниже перечислены некоторые возможные значения.
type
Тип метода EAP, который вызвал ошибку во время проверки подлинности 802.1X. Структура EAP_METHOD_TYPE определена в файле заголовка Eaptypes.h .
dwReasonCode
Причина сбоя метода EAP. Некоторые значения для этого элемента определяются в файле заголовка Eaphosterror.h , а некоторые — в файле заголовка Winerror.h , хотя возможны и другие значения.
Возможные значения перечислены ниже.
| Значение | Значение |
|---|---|
|
Один или несколько аргументов неверны. |
|
Недопустимые данные. |
|
Неправильный параметр. |
|
EAPHost получил сбой EAP после обмена удостоверениями. Скорее всего, возникла проблема с учетной записью пользователя с проверкой подлинности. |
|
Используйте FormatMessage , чтобы получить строку сообщения для возвращаемой ошибки. |
rootCauseGuid
Уникальный идентификатор, определяющий причину ошибки в EAPHost. Метод EAP может определить новый GUID и связать его с определенной первопричиной. Существующие значения для этого элемента определяются в файле заголовка Eaphosterror.h .
repairGuid
Уникальный идентификатор, который сопоставляется с локализуемой строкой, определяющей действие по восстановлению, которое можно предпринять для исправления сообщаемой ошибки. Существующие значения для этого элемента определяются в файле заголовка Eaphosterror.h .
helpLinkGuid
Уникальный идентификатор, который сопоставляется с локализуемой строкой, указывающей URL-адрес страницы, содержащей дополнительные сведения об ошибке или сообщении об исправлении. Метод EAP потенциально может определить новый GUID и связать с одной конкретной ссылкой на справку. Некоторые из существующих значений для этого элемента определяются в файле заголовка Eaphosterror.h .
fRootCauseString
Указывает, содержит ли структура ONEX_EAP_ERROR строку первопричины в элементе RootCauseString .
fRepairString
Указывает, содержит ли структура ONEX_EAP_ERROR строку восстановления в элементе RepairString .
RootCauseString
Локализованная и удобочитаемая строка, описывающая основную причину ошибки. Этот элемент содержит строку Юникода, завершающуюся значением NULL, начиная с члена dwOffsetONEX_VARIABLE_BLOB если задан элемент bitfield fRootCauseString .
RepairString
Локализованная и удобочитаемая строка, описывающая возможные действия по восстановлению. Этот элемент содержит строку Юникода, завершающуюся значением NULL, начиная с элемента dwOffsetONEX_VARIABLE_BLOB , если задан элемент битового поля fRepairString .
Комментарии
Структура ONEX_EAP_ERROR используется модулем 802.1X— новым компонентом конфигурации беспроводной сети, поддерживаемым в Windows Vista и более поздних версиях.
Многие элементы структуры ONEX_EAP_ERROR соответствуют аналогичным элементам в EAP_ERROR структуре
ONEX_RESULT_UPDATE_DATA содержит сведения об изменении состояния проверки подлинности на 802.1X. Структура ONEX_RESULT_UPDATE_DATA возвращается, когда элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATAWLAN_NOTIFICATION_SOURCE_ONEX , а элемент NotificationCodeструктуры WLAN_NOTIFICATION_DATA для полученного уведомления — OneXNotificationTypeResultUpdate. Для этого уведомления член pDataструктуры WLAN_NOTIFICATION_DATA указывает на структуру ONEX_RESULT_UPDATE_DATA , содержащую сведения об изменении состояния проверки подлинности 802.1X.
Если элемент fEapError в структуре ONEX_RESULT_UPDATE_DATA задан, то элемент eapError структуры ONEX_RESULT_UPDATE_DATA содержит структуру ONEX_VARIABLE_BLOB со встроенной ONEX_EAP_ERROR структурой, начиная с элемента dwOffsetONEX_VARIABLE_BLOB.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Верхняя часть | dot1x.h |