ONEX_RESULT_UPDATE_DATA structure (dot1x.h)

The ONEX_RESULT_UPDATE_DATA structure contains information on a status change to 802.1X authentication.

Syntax

typedef struct _ONEX_RESULT_UPDATE_DATA {
  ONEX_STATUS                     oneXStatus;
  ONEX_EAP_METHOD_BACKEND_SUPPORT BackendSupport;
  BOOL                            fBackendEngaged;
  DWORD                           fOneXAuthParams : 1;
  DWORD                           fEapError : 1;
  ONEX_VARIABLE_BLOB              authParams;
  ONEX_VARIABLE_BLOB              eapError;
} ONEX_RESULT_UPDATE_DATA, *PONEX_RESULT_UPDATE_DATA;

Members

oneXStatus

Specifies the current 802.1X authentication status. For more information, see the ONEX_STATUS structure.

BackendSupport

Indicates if the configured EAP method on the supplicant is supported on the 802.1X authentication server.

EAP permits the use of a backend authentication server, which may implement some or all authentication methods, with the authenticator acting as a pass-through for some or all methods and peers. For more information, see RFC 3748 published by the IETF and the ONEX_EAP_METHOD_BACKEND_SUPPORT enumeration.

fBackendEngaged

Indicates if a response was received from the 802.1X authentication server.

fOneXAuthParams

Indicates if the ONEX_RESULT_UPDATE_DATA structure contains 802.1X authentication parameters in the authParams member.

fEapError

Indicates if the ONEX_RESULT_UPDATE_DATA structure contains an EAP error in the eapError member.

authParams

The 802.1X authentication parameters. This member contains an embedded ONEX_AUTH_PARAMS structure starting at the dwOffset member of the ONEX_VARIABLE_BLOB if the fOneXAuthParams bitfield member is set.

eapError

An EAP error value. This member contains an embedded ONEX_EAP_ERROR structure starting at the dwOffset member of the ONEX_VARIABLE_BLOB if the fEapError bitfield member is set.

Remarks

The ONEX_RESULT_UPDATE_DATA 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.This 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.

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_AUTH_PARAMS

ONEX_EAP_ERROR

ONEX_EAP_METHOD_BACKEND_SUPPORT

ONEX_NOTIFICATION_TYPE

ONEX_STATUS

ONEX_VARIABLE_BLOB

WLAN_NOTIFICATION_DATA

WlanRegisterNotification