ONEX_STATUS structure (dot1x.h)

The ONEX_STATUS structure contains the current 802.1X authentication status.

Syntax

typedef struct _ONEX_STATUS {
  ONEX_AUTH_STATUS authStatus;
  DWORD            dwReason;
  DWORD            dwError;
} ONEX_STATUS, *PONEX_STATUS;

Members

authStatus

The current status of the 802.1X authentication process. Any error that may have occurred during authentication is indicated below by the value of the dwReason and dwError members of the ONEX_STATUS structure. For more information, see the ONEX_AUTH_STATUS enumeration.

dwReason

If an error occurred during 802.1X authentication, this member contains the reason for the error specified as a value from the ONEX_REASON_CODE enumeration. This member is normally ONEX_REASON_CODE_SUCCESS when 802.1X authentication is successful and no error occurs.

dwError

If an error occurred during 802.1X authentication, this member contains the error. This member is normally NO_ERROR, except when an EAPHost error occurs.

Remarks

The ONEX_STATUS structure is used by the 802.1X module, a new wireless configuration component supported on Windows Vista and later.

The ONEX_RESULT_UPDATE_DATA contains information on a status change to 802.1X authentication. The ONEX_RESULT_UPDATE_DATA structure is returned when the NotificationSource member of the WLAN_NOTIFICATION_DATA structure is WLAN_NOTIFICATION_SOURCE_ONEX and the NotificationCode member of the WLAN_NOTIFICATION_DATA structure for received notification is OneXNotificationTypeResultUpdate. For this notification, the pData member of the WLAN_NOTIFICATION_DATA structure points to an ONEX_RESULT_UPDATE_DATA structure that contains information on the 802.1X authentication status change.

The oneXStatus member of the ONEX_RESULT_UPDATE_DATA structure contains an ONEX_STATUS structure.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header dot1x.h

See also

About the ACM Architecture

ONEX_NOTIFICATION_TYPE

ONEX_REASON_CODE

ONEX_RESULT_UPDATE_DATA

WLAN_NOTIFICATION_DATA

WlanRegisterNotification