estrutura ONEX_EAP_ERROR (dot1x.h)
A estrutura ONEX_EAP_ERROR contém o erro EAP 802.1X quando ocorre um erro com a autenticação 802.1X.
Sintaxe
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;
Membros
dwWinError
O valor de erro definido no arquivo de cabeçalho Winerror.h . Esse membro também às vezes contém o motivo pelo qual o método EAP falhou. Os valores existentes para esse membro pelo motivo pelo qual o método EAP falhou são definidos no arquivo de cabeçalho Eaphosterror.h .
Alguns valores possíveis estão listados abaixo.
type
O tipo de método EAP que gerou o erro durante a autenticação 802.1X. A estrutura EAP_METHOD_TYPE é definida no arquivo de cabeçalho Eaptypes.h .
dwReasonCode
O motivo pelo qual o método EAP falhou. Alguns dos valores desse membro são definidos no arquivo de cabeçalho Eaphosterror.h e alguns são definidos no arquivo de cabeçalho Winerror.h , embora outros valores sejam possíveis.
Os valores possíveis são listados abaixo.
| Valor | Significado |
|---|---|
|
Um ou mais argumentos não estão corretos. |
|
Os dados não são válidos. |
|
Um parâmetro está incorreto. |
|
O EAPHost recebeu falha de EAP após a troca de identidade. Provavelmente há um problema com a conta do usuário de autenticação. |
|
Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado. |
rootCauseGuid
Uma ID exclusiva que identifica a causa do erro no EAPHost. Um método EAP pode definir um novo GUID e associar o GUID a uma causa raiz específica. Os valores existentes para esse membro são definidos no arquivo de cabeçalho Eaphosterror.h .
repairGuid
Uma ID exclusiva que é mapeada para uma cadeia de caracteres localizável que identifica a ação de reparo que pode ser executada para corrigir o erro relatado. Os valores existentes para esse membro são definidos no arquivo de cabeçalho Eaphosterror.h .
helpLinkGuid
Uma ID exclusiva que é mapeada para uma cadeia de caracteres localizável que especifica uma URL para uma página que contém informações adicionais sobre uma mensagem de erro ou reparo. Um método EAP pode potencialmente definir um novo GUID e associar a um link de ajuda específico. Alguns dos valores existentes para esse membro são definidos no arquivo de cabeçalho Eaphosterror.h .
fRootCauseString
Indica se a estrutura ONEX_EAP_ERROR contém uma cadeia de caracteres de causa raiz no membro RootCauseString .
fRepairString
Indica se a estrutura ONEX_EAP_ERROR contém uma cadeia de caracteres de reparo no membro RepairString .
RootCauseString
Uma cadeia de caracteres localizada e legível que descreve a causa raiz do erro. Esse membro contém uma cadeia de caracteres Unicode terminada em NULL começando no membro dwOffset do ONEX_VARIABLE_BLOB se o membro de campo de bits fRootCauseString estiver definido.
RepairString
Uma cadeia de caracteres localizada e legível que descreve a possível ação de reparo. Esse membro contém uma cadeia de caracteres Unicode terminada em NULL começando no membro dwOffset do ONEX_VARIABLE_BLOB se o membro do campo de bits fRepairString estiver definido.
Comentários
A estrutura ONEX_EAP_ERROR é usada pelo módulo 802.1X, um novo componente de configuração sem fio com suporte no Windows Vista e posterior.
Muitos membros da estrutura ONEX_EAP_ERROR correspondem a membros semelhantes na estrutura EAP_ERROR
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 fEapError na estrutura ONEX_RESULT_UPDATE_DATA estiver definido, o membro eapError da estrutura ONEX_RESULT_UPDATE_DATA conterá uma estrutura ONEX_VARIABLE_BLOB com uma estrutura ONEX_EAP_ERROR inserida começando no membro dwOffset do ONEX_VARIABLE_BLOB.
Requisitos
| 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] |
| Cabeçalho | dot1x.h |