ONEX_REASON_CODE enumeração (dot1x.h)

Artigo
08/23/2023

O tipo enumerado ONEX_REASON_CODE especifica os valores possíveis que indicam o motivo pelo qual a autenticação 802.1X falhou.

Syntax

typedef enum _ONEX_REASON_CODE {
  ONEX_REASON_CODE_SUCCESS = 0,
  ONEX_REASON_START,
  ONEX_UNABLE_TO_IDENTIFY_USER,
  ONEX_IDENTITY_NOT_FOUND,
  ONEX_UI_DISABLED,
  ONEX_UI_FAILURE,
  ONEX_EAP_FAILURE_RECEIVED,
  ONEX_AUTHENTICATOR_NO_LONGER_PRESENT,
  ONEX_NO_RESPONSE_TO_IDENTITY,
  ONEX_PROFILE_VERSION_NOT_SUPPORTED,
  ONEX_PROFILE_INVALID_LENGTH,
  ONEX_PROFILE_DISALLOWED_EAP_TYPE,
  ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG,
  ONEX_PROFILE_INVALID_ONEX_FLAGS,
  ONEX_PROFILE_INVALID_TIMER_VALUE,
  ONEX_PROFILE_INVALID_SUPPLICANT_MODE,
  ONEX_PROFILE_INVALID_AUTH_MODE,
  ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES,
  ONEX_UI_CANCELLED,
  ONEX_PROFILE_INVALID_EXPLICIT_CREDENTIALS,
  ONEX_PROFILE_EXPIRED_EXPLICIT_CREDENTIALS,
  ONEX_UI_NOT_PERMITTED
} ONEX_REASON_CODE, PONEX_REASON_CODE;

Constantes


`ONEX_REASON_CODE_SUCCESS` Valor: 0 Indica que a autenticação 802.1X foi um sucesso.
`ONEX_REASON_START` Indica o início do intervalo que especifica os valores possíveis para o código de motivo 802.1X.
`ONEX_UNABLE_TO_IDENTIFY_USER` O módulo 802.1X não pôde identificar um conjunto de credenciais a serem usadas. Um exemplo é quando o modo de autenticação é definido como usuário, mas nenhum usuário está conectado.
`ONEX_IDENTITY_NOT_FOUND` O módulo EAP não pôde adquirir uma identidade para o usuário. Portanto, o valor não é usado no momento. Todos os erros específicos do EAP são retornados como ONEX_EAP_FAILURE_RECEIVED.
`ONEX_UI_DISABLED` Para continuar com a autenticação 802.1X, o sistema precisa solicitar a entrada do usuário, mas a interface do usuário está desabilitada. No Windows Vista e no Windows Server 2008, esse valor poderá ser retornado se um método EAP solicitar a entrada do usuário para um perfil para autenticação de computador local ou convidado. No Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado, esse valor não deve ser retornado.
`ONEX_UI_FAILURE` O módulo de autenticação 802.1X não pôde retornar a entrada do usuário solicitada. No Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado, esse valor poderá ser retornado se um método EAP solicitar a entrada do usuário, mas a interface do usuário não puder ser exibida (o ícone de rede foi configurado para não ser exibido na barra de tarefas, por exemplo).
`ONEX_EAP_FAILURE_RECEIVED` O módulo EAP retornou um código de erro. A estrutura ONEX_EAP_ERROR pode conter informações adicionais sobre o erro EAP específico (um certificado não encontrado, por exemplo).
`ONEX_AUTHENTICATOR_NO_LONGER_PRESENT` O par com o qual o módulo 802.1X estava negociando não está mais presente ou não está respondendo (um cliente laptop saiu do intervalo do ponto de acesso sem fio, por exemplo).
`ONEX_NO_RESPONSE_TO_IDENTITY` Nenhuma resposta foi recebida a um pacote de resposta de identidade EAP. Esse valor indica um problema com a infraestrutura (um link entre o ponto de acesso sem fio e o servidor de autenticação não está funcionando, por exemplo).
`ONEX_PROFILE_VERSION_NOT_SUPPORTED` O módulo 802.1X não dá suporte a essa versão do perfil.
`ONEX_PROFILE_INVALID_LENGTH` O membro de comprimento especificado no perfil 802.1X é inválido.
`ONEX_PROFILE_DISALLOWED_EAP_TYPE` O tipo EAP especificado no perfil 802.1X não é permitido para essa mídia. Um exemplo é quando o algoritmo MD5 com chave é usado para transmissão sem fio.
`ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG` O tipo EAP ou sinalizadores EAP especificados no perfil 802.1X não são válidos. Um exemplo é quando o tipo EAP não está instalado no sistema.
`ONEX_PROFILE_INVALID_ONEX_FLAGS` Os sinalizadores 802.1X especificados no perfil 802.1X não são válidos.
`ONEX_PROFILE_INVALID_TIMER_VALUE` Um ou mais valores de temporizador especificados no perfil 802.1X estão fora de seu intervalo válido.
`ONEX_PROFILE_INVALID_SUPPLICANT_MODE` O modo suplicante especificado no perfil 802.1X não é válido.
`ONEX_PROFILE_INVALID_AUTH_MODE` O modo de autenticação especificado no perfil 802.1X não é válido.
`ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES` As propriedades de conexão EAP especificadas no perfil 802.1X não são válidas.
`ONEX_UI_CANCELLED` A entrada do usuário foi cancelada. Esse valor poderá ser retornado se um método EAP solicitar a entrada do usuário, mas o usuário apertar o botão Cancelar ou ignorar a caixa de diálogo de entrada do usuário. Esse valor tem suporte no Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado.
`ONEX_PROFILE_INVALID_EXPLICIT_CREDENTIALS` As credenciais de usuário salvas não são válidas. Esse valor poderá ser retornado se um perfil tiver sido salvo com credenciais incorretas (uma senha incorreta, por exemplo), já que as credenciais não serão testadas até que o perfil seja realmente usado para estabelecer uma conexão. Esse valor tem suporte no Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado.
`ONEX_PROFILE_EXPIRED_EXPLICIT_CREDENTIALS` As credenciais de usuário salvas expiraram. Esse valor poderá ser retornado se um perfil tiver sido salvo com credenciais e as credenciais expirarem posteriormente (expiração de senha após algum período de tempo, por exemplo). Esse valor tem suporte no Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado.
`ONEX_UI_NOT_PERMITTED` A interface do usuário não é permitida. No Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado, esse valor poderá ser retornado se um método EAP solicitar a entrada do usuário e o perfil estiver configurado com as credenciais do usuário salvas por outro usuário e não o usuário conectado no momento. Esse valor tem suporte no Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado.

Comentários

O ONEX_REASON_CODE tipo enumerado é usado 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 do status de autenticação 802.1X.

O membro oneXStatus da estrutura de ONEX_RESULT_UPDATE_DATA contém uma estrutura ONEX_STATUS . Se ocorreu um erro durante a autenticação 802.1X, o membro dwReason dessa estrutura ONEX_STATUS contém o motivo do erro especificado como um valor da enumeração ONEX_REASON_CODE .

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