WDI_SAE_STATUS enumeration (wditypes.hpp)

Important

This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. 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 WDI_SAE_STATUS enumeration defines SAE authentication failure error status codes. This enumeration is used to provide failure codes from the OS to the miniport driver, or from the driver to the OS.

Syntax

typedef enum _WDI_SAE_STATUS {
  WDI_SAE_STATUS_SUCCESS,
  WDI_SAE_STATUS_FAILURE,
  WDI_SAE_STATUS_RESOURCES,
  WDI_SAE_STATUS_INTERNAL_AUTH_FAILURE,
  WDI_SAE_STATUS_INVALID_PEER,
  WDI_SAE_STATUS_INITIALIZATION_NO_KEY,
  WDI_SAE_STATUS_INITIALIZATION_H2E_NOT_SUPPORTED,
  WDI_SAE_STATUS_INITIALIZATION_PWD_ID_NOT_SUPPORTED,
  WDI_SAE_STATUS_COMMIT_MESSAGE_RECEIVED_IN_NOTHING_STATE,
  WDI_SAE_STATUS_COMMIT_MESSAGE_MALFORMED_AUTH_FRAME,
  WDI_SAE_STATUS_COMMIT_MESSAGE_FAILURE_FROM_PEER,
  WDI_SAE_STATUS_COMMIT_MESSAGE_FINITE_GROUP_NOT_PRESENT,
  WDI_SAE_STATUS_COMMIT_MESSAGE_UNSUPPORTED_FINITE_GROUP,
  WDI_SAE_STATUS_COMMIT_MESSAGE_ANTICLOGGING_TOKEN_REQUIRED_BUT_NO_TOKEN,
  WDI_SAE_STATUS_COMMIT_MESSAGE_INVALID_SCALAR_ELEMENT_SIZE,
  WDI_SAE_STATUS_COMMIT_MESSAGE_REFLECTION_ATTACK_DETECTED,
  WDI_SAE_STATUS_COMMIT_MESSAGE_INTERNAL_COMPUTATION_ERROR,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_RECEIVED_IN_INVALID_STATE,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_MALFORMED_AUTH_FRAME,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_FAILURE_FROM_PEER,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_BSS_TRANSITION_REQUESTED,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_INTERNAL_COMPUTATION_ERROR,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_VERIFICATION_FAILED,
  WDI_SAE_STATUS_CONFIRM_MESSAGE_RESEND_REQUEST,
  WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_COMMIT_REQUEST,
  WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_CONFIRM_REQUEST,
  WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_STATUS,
  WDI_SAE_STATUS_CONNECTION_CLEANED_UP,
  WDI_SAE_STATUS_CLEAN_UP_CONTEXT
} WDI_SAE_STATUS;

Constants

WDI_SAE_STATUS_SUCCESS The operation completed successfully.
WDI_SAE_STATUS_FAILURE The operation completed with failure.
WDI_SAE_STATUS_RESOURCES WDI or the driver encountered a resource allocation error.
WDI_SAE_STATUS_INTERNAL_AUTH_FAILURE WDI encountered an internal authentication-related failure.
WDI_SAE_STATUS_INVALID_PEER The Commit or Confirm response was received from an AP for which WDI did not provide SAE parameters.
WDI_SAE_STATUS_INITIALIZATION_NO_KEY WDI does not have the password for this association request.
WDI_SAE_STATUS_INITIALIZATION_H2E_NOT_SUPPORTED AP requires Hash-To-Element support but the driver doesn't support Hash-To-Element.
WDI_SAE_STATUS_INITIALIZATION_PWD_ID_NOT_SUPPORTED AP requires Password-Identifier, but no Password-Identifier is available.
WDI_SAE_STATUS_COMMIT_MESSAGE_RECEIVED_IN_NOTHING_STATE The Commit message was received in the Nothing state.
WDI_SAE_STATUS_COMMIT_MESSAGE_MALFORMED_AUTH_FRAME A bad Commit frame was received.
WDI_SAE_STATUS_COMMIT_MESSAGE_FAILURE_FROM_PEER The Commit frame from the peer contained an error code.
WDI_SAE_STATUS_COMMIT_MESSAGE_FINITE_GROUP_NOT_PRESENT The Finite group was not present in the Commit frame.
WDI_SAE_STATUS_COMMIT_MESSAGE_UNSUPPORTED_FINITE_GROUP The Finite group specified in the Commit frame is not supported.
WDI_SAE_STATUS_COMMIT_MESSAGE_ANTICLOGGING_TOKEN_REQUIRED_BUT_NO_TOKEN 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 The Commit frame did not contain enough space for the Scalar or Element fields.
WDI_SAE_STATUS_COMMIT_MESSAGE_REFLECTION_ATTACK_DETECTED WDI detected a reflection attack.
WDI_SAE_STATUS_COMMIT_MESSAGE_INTERNAL_COMPUTATION_ERROR WDI encountered an internal computation error.
WDI_SAE_STATUS_CONFIRM_MESSAGE_RECEIVED_IN_INVALID_STATE WDI received a Confirm frame when it was not expected.
WDI_SAE_STATUS_CONFIRM_MESSAGE_MALFORMED_AUTH_FRAME A bad Confirm frame was received.
WDI_SAE_STATUS_CONFIRM_MESSAGE_FAILURE_FROM_PEER An error was received in the Confirm frame.
WDI_SAE_STATUS_CONFIRM_MESSAGE_BSS_TRANSITION_REQUESTED WDI does not handle the BSS transition request.
WDI_SAE_STATUS_CONFIRM_MESSAGE_INTERNAL_COMPUTATION_ERROR WDI encountered an internal error.
WDI_SAE_STATUS_CONFIRM_MESSAGE_VERIFICATION_FAILED WDI failed to match the Verifier from the Confirm frame.
WDI_SAE_STATUS_CONFIRM_MESSAGE_RESEND_REQUEST 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 The driver timed out waiting for a Commit Request from the OS.
WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_CONFIRM_REQUEST The driver timed out waiting for a Confirm Request from the OS.
WDI_SAE_STATUS_TIMEOUT_WAITING_FOR_STATUS The driver timed out waiting for a Status from the OS.
WDI_SAE_STATUS_CONNECTION_CLEANED_UP Internal handling code.
WDI_SAE_STATUS_CLEAN_UP_CONTEXT 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 10, version 1903
Header	wditypes.hpp

See also

WPA3-SAE Authentication

OID_WDI_SET_SAE_AUTH_PARAMS

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED