ONEX_REASON_CODE enumeration

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.
 

The ONEX_REASON_CODE enumeration specifies reasons that authentication of an 802.1X module failed.

Syntax


typedef enum _ONEX_REASON_CODE { 
  ONEX_REASON_CODE_SUCCESS                        = 0,
  ONEX_REASON_START                               = L2_REASON_CODE_ONEX_BASE,
  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;

Constants

ONEX_REASON_CODE_SUCCESS

The 802.1X authentication completed successfully.

ONEX_REASON_START

Indicates that a variable of type ONEX_REASON_CODE has not yet been assigned a meaningful value.

ONEX_UNABLE_TO_IDENTIFY_USER

The 802.1X module was unable to identify a set of credentials to be used. An example is when the authentication mode is set to "User" but no user is logged on.

ONEX_IDENTITY_NOT_FOUND

The EAP module was unable to acquire an identity for the user. An example is when EAP-TLS is used with user authentication and the user's certificate store has no certificate.

ONEX_UI_DISABLED

To proceed with authentication, the 802.1X module needs to display a user interface, but the user interface is disabled. An example is when automatic system authentication is enabled.

ONEX_UI_FAILURE

An error occurred when the 802.1X module was unable to display a user interface for authentication. An example is when the networking system tray icon is disabled.

ONEX_EAP_FAILURE_RECEIVED

The EAP module returned an error code.

ONEX_AUTHENTICATOR_NO_LONGER_PRESENT

The peer with which the 802.1X module was negotiating is no longer present.

ONEX_NO_RESPONSE_TO_IDENTITY

No response was received to an EAP identity response packet.

ONEX_PROFILE_VERSION_NOT_SUPPORTED

The 802.1X module does not support this version of the profile.

ONEX_PROFILE_INVALID_LENGTH

The length member specified in the 802.1X profile is invalid.

ONEX_PROFILE_DISALLOWED_EAP_TYPE

The EAP type specified in the 802.1X profile is not allowed for this media. An example is when the keyed MD5 algorithm is used for wireless transmission.

ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG

The EAP type or EAP flags specified in the 802.1X profile are invalid. An example is when EAP type is not installed on the system.

ONEX_PROFILE_INVALID_ONEX_FLAGS

The 802.1X flags specified in the 802.1X profile are invalid.

ONEX_PROFILE_INVALID_TIMER_VALUE

One or more timer values specified in the 802.1X profile is out of its valid range.

ONEX_PROFILE_INVALID_SUPPLICANT_MODE

The supplicant mode specified in the 802.1X profile is invalid.

ONEX_PROFILE_INVALID_AUTH_MODE

The authentication mode specified in the 802.1X profile is invalid.

ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES

The EAP connection properties specified in the 802.1X profile are invalid.

ONEX_UI_CANCELLED

User input was canceled. This value can be returned if an EAP method requested user input, but the user hit the Cancel button or dismissed the user input dialog.

This value is supported starting on Windows 7 and Windows Server 2008 R2 with the Wireless LAN Service installed.

ONEX_PROFILE_INVALID_EXPLICIT_CREDENTIALS

The saved user credentials are not valid. This value can be returned if a profile was saved with bad credentials (an incorrect password, for example), since the credentials are not tested until the profile is actually used to establish a connection.

This value is supported starting on Windows 7 and Windows Server 2008 R2 with the Wireless LAN Service installed.

ONEX_PROFILE_EXPIRED_EXPLICIT_CREDENTIALS

The saved user credentials have expired. This value can be returned if a profile was saved with credentials and the credentials subsequently expired (password expirarion after some period of time, for example).

This value is supported starting on Windows 7 and Windows Server 2008 R2 with the Wireless LAN Service installed.

ONEX_UI_NOT_PERMITTED

User interface is not permitted. This value can be returned if an EAP method requested user input and the profile is configured with user credentials saved by another user and not the currently logged in user.

This value is supported starting on Windows 7 and Windows Server 2008 R2 with the Wireless LAN Service installed.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Dot1x.h (include Dot1x.h)

 

 

Send comments about this topic to Microsoft

Show: