WDI_SAE_STATUS enumeration (dot11wificxtypes.h)

Important

This topic is part of the WiFiCx driver model. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features. The previous Wi-Fi driver model WDI is in maintenance mode and will only receive high priority fixes.

The WDI_SAE_STATUS enumeration defines SAE authentication failure error status codes. This enumeration is used to provide failure codes from the OS to the WiFiCx driver, or from the driver to the OS.

Syntax

typedef enum _WDI_SAE_STATUS {
  WDI_SAE_STATUS_SUCCESS = 0,
  WDI_SAE_STATUS_FAILURE = 1,
  WDI_SAE_STATUS_RESOURCES = 2,
  WDI_SAE_STATUS_INTERNAL_AUTH_FAILURE = 3,
  WDI_SAE_STATUS_INVALID_PEER = 4,
  WDI_SAE_STATUS_INITIALIZATION_NO_KEY = 5,
  WDI_SAE_STATUS_INITIALIZATION_H2E_NOT_SUPPORTED = 6,
  WDI_SAE_STATUS_INITIALIZATION_PWD_ID_NOT_SUPPORTED = 7,
  WDI_SAE_STATUS_COMMIT_MESSAGE_RECEIVED_IN_NOTHING_STATE = 10,
  WDI_SAE_STATUS_COMMIT_MESSAGE_MALFORMED_AUTH_FRAME = 11,
  WDI_SAE_STATUS_COMMIT_MESSAGE_FAILURE_FROM_PEER = 12,
  WDI_SAE_STATUS_COMMIT_MESSAGE_FINITE_GROUP_NOT_PRESENT = 13,
  WDI_SAE_STATUS_COMMIT_MESSAGE_UNSUPPORTED_FINITE_GROUP = 14,
  WDI_SAE_STATUS_COMMIT_MESSAGE_ANTICLOGGING_TOKEN_REQUIRED_BUT_NO_TOKEN = 15,
  WDI_SAE_STATUS_COMMIT_MESSAGE_INVALID_SCALAR_ELEMENT_SIZE = 16,
  WDI_SAE_STATUS_COMMIT_MESSAGE_REFLECTION_ATTACK_DETECTED = 17,
  WDI_SAE_STATUS_COMMIT_MESSAGE_INTERNAL_COMPUTATION_ERROR = 18,
  WDI_SAE_STATUS_COMMIT_MESSAGE_INVALID_REJECTED_GROUP = 19,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_RECEIVED_IN_INVALID_STATE = 30,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_MALFORMED_AUTH_FRAME = 31,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_FAILURE_FROM_PEER = 32,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_BSS_TRANSITION_REQUESTED = 33,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_INTERNAL_COMPUTATION_ERROR = 34,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_VERIFICATION_FAILED = 35,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_RESEND_REQUEST = 50,
  WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_COMMIT_REQUEST = 51,
  WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_CONFIRM_REQUEST = 52,
  WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_STATUS = 53,
  WDI_SAE_STATUS_CONNECTION_CLEANED_UP = 70,
  WDI_SAE_STATUS_CLEAN_UP_CONTEXT = 71
} WDI_SAE_STATUS;

Constants

 
WDI_SAE_STATUS_SUCCESS
Value: 0
The operation completed successfully.
WDI_SAE_STATUS_FAILURE
Value: 1
The operation completed with failure and none of the other status codes apply.
WDI_SAE_STATUS_RESOURCES
Value: 2
The driver encountered a resource allocation error.
WDI_SAE_STATUS_INTERNAL_AUTH_FAILURE
Value: 3
WDI encountered an internal authentication-related failure.
WDI_SAE_STATUS_INVALID_PEER
Value: 4
The Commit or Confirm response was received from an AP for which WDI did not provide SAE parameters.
WDI_SAE_STATUS_INITIALIZATION_NO_KEY
Value: 5
WDI doesn't have the password for this association request.
WDI_SAE_STATUS_INITIALIZATION_H2E_NOT_SUPPORTED
Value: 6
AP requires Hash-To-Element support but the driver doesn't support Hash-To-Element.
WDI_SAE_STATUS_INITIALIZATION_PWD_ID_NOT_SUPPORTED
Value: 7
AP requires Password-Identifier, but no Password-Identifier is available.
WDI_SAE_STATUS_COMMIT_MESSAGE_RECEIVED_IN_NOTHING_STATE
Value: 10
Commit message was received in Nothing state.
WDI_SAE_STATUS_COMMIT_MESSAGE_MALFORMED_AUTH_FRAME
Value: 11
A bad Commit frame was received.
WDI_SAE_STATUS_COMMIT_MESSAGE_FAILURE_FROM_PEER
Value: 12
The commit frame from the peer contained an error code.
WDI_SAE_STATUS_COMMIT_MESSAGE_FINITE_GROUP_NOT_PRESENT
Value: 13
The Finite Group was not present in the Commit frame.
WDI_SAE_STATUS_COMMIT_MESSAGE_UNSUPPORTED_FINITE_GROUP
Value: 14
The Finite Group specified in the Commit frame is not supported.
WDI_SAE_STATUS_COMMIT_MESSAGE_ANTICLOGGING_TOKEN_REQUIRED_BUT_NO_TOKEN
Value: 15
The Commit frame contained the error code requiring the anti-clogging token, but the frame did not contain the anti-clogging token.
WDI_SAE_STATUS_COMMIT_MESSAGE_INVALID_SCALAR_ELEMENT_SIZE
Value: 16
The Commit frame did not contain enough space for the Scalar or Element fields.
WDI_SAE_STATUS_COMMIT_MESSAGE_REFLECTION_ATTACK_DETECTED
Value: 17
WDI detected a reflection attack.
WDI_SAE_STATUS_COMMIT_MESSAGE_INTERNAL_COMPUTATION_ERROR
Value: 18
WDI encountered an internal computation error.
WDI_SAE_STATUS_COMMIT_MESSAGE_INVALID_REJECTED_GROUP
WDI rejected the commit frame because it included a group in the Rejected Groups field that the OS actually supports.
WDI_SAE_STATUS_CONFIRM_MESSAGE_RECEIVED_IN_INVALID_STATE
Value: 30
WDI received a Confirm frame when it was not expected.
WDI_SAE_STATUS_CONFIRM_MESSAGE_MALFORMED_AUTH_FRAME
Value: 31
A bad Confirm frame was received.
WDI_SAE_STATUS_CONFIRM_MESSAGE_FAILURE_FROM_PEER
Value: 32
An error was received in the Confirm frame.
WDI_SAE_STATUS_CONFIRM_MESSAGE_BSS_TRANSITION_REQUESTED
Value: 33
WDI doesn't handle the Bss transition request.
WDI_SAE_STATUS_CONFIRM_MESSAGE_INTERNAL_COMPUTATION_ERROR
Value: 34
WDI encountered an internal error.
WDI_SAE_STATUS_CONFIRM_MESSAGE_VERIFICATION_FAILED
Value: 35
WDI failed to match the Verifier from the Confirm frame.
WDI_SAE_STATUS_CONFIRM_MESSAGE_RESEND_REQUEST
Value: 50
The driver requests a new set of Confirm frame parameters to resend the Confirm request to the AP.
WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_COMMIT_REQUEST
Value: 51
The driver timed out waiting for a Commit Request from the OS.
WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_CONFIRM_REQUEST
Value: 52
The driver timed out waiting for a Confirm Request from the OS.
WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_STATUS
Value: 53
The driver timed out waiting for a Status from the OS.
WDI_SAE_STATUS_CONNECTION_CLEANED_UP
Value: 70
Internal handling code.
WDI_SAE_STATUS_CLEAN_UP_CONTEXT
Value: 71
Internal handling code.

Remarks

This enumeration is a value in both the OID_WDI_SET_SAE_AUTH_PARAMS command and the NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED indication.

Requirements

Requirement Value
Minimum supported client Windows 11
Header dot11wificxtypes.h

See also

WPA3-SAE Authentication

OID_WDI_SET_SAE_AUTH_PARAMS

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED