WLAN_REASON_CODE (Compact 7)
3/12/2014
This structure includes reasons why a wireless local area network (WLAN) operation did not complete.
Syntax
typedef DWORD WLAN_REASON_CODE, *PWLAN_REASON_CODE;
Reason Code Tables
| General Error Codes | Meaning |
|---|---|
WLAN_REASON_CODE_SUCCESS |
The operation succeeds. |
WLAN_REASON_CODE_UNKNOWN |
The reason for failure is unknown. |
| Automatic Configuration Error Codes | Meaning |
|---|---|
WLAN_REASON_CODE_NETWORK_NOT_COMPATIBLE |
The wireless network is incompatible. |
WLAN_REASON_CODE_PROFILE_NOT_COMPATIBLE |
The wireless network profile is incompatible. |
| Automatic Connection Error Codes | Meaning |
|---|---|
WLAN_REASON_CODE_NO_AUTO_CONNECTION |
The profile specifies no auto connection. |
WLAN_REASON_CODE_NOT_VISIBLE |
The wireless network is not visible. |
WLAN_REASON_CODE_USER_DENIED |
The wireless network is blocked by the user. |
WLAN_REASON_CODE_BSS_TYPE_NOT_ALLOWED |
The basic service set (BSS) type is not allowed on this wireless adapter. |
WLAN_REASON_CODE_IN_FAILED_LIST |
The wireless network is in the failed list. |
WLAN_REASON_CODE_IN_BLOCKED_LIST |
The wireless network is in the blocked list. |
WLAN_REASON_CODE_SSID_LIST_TOO_LONG |
The size of the service set identifiers (SSID) list exceeds the maximum size supported by the adapter. |
WLAN_REASON_CODE_CONNECT_CALL_FAIL |
The Media Specific Module (MSM) connect call fails. |
WLAN_REASON_CODE_SCAN_CALL_FAIL |
The MSM scan call fails. |
WLAN_REASON_CODE_NETWORK_NOT_AVAILABLE |
The specified network is not available. This reason code is also used when there is a mismatch between capabilities specified in an XML profile and interface or network capabilities. For example, if a profile specifies the use of WPA2 when the network adapter supports WPA only, this error code is returned. If a profile specifies the use of FIPS mode when the network adapter does not support FIPS mode, this error code is returned. |
WLAN_REASON_CODE_PROFILE_CHANGED_OR_DELETED |
The profile was changed or deleted before the connection was established. |
WLAN_REASON_CODE_KEY_MISMATCH |
The profile key does not match the network key. |
WLAN_REASON_CODE_USER_NOT_RESPOND |
The user is not responding. |
| Profile Validation Error Codes | Meaning |
|---|---|
WLAN_REASON_CODE_INVALID_PROFILE_SCHEMA |
The profile is invalid according to the schema. |
WLAN_REASON_CODE_PROFILE_MISSING |
The WLANProfile element is missing. |
WLAN_REASON_CODE_INVALID_PROFILE_NAME |
The name of the profile is invalid. |
WLAN_REASON_CODE_INVALID_PROFILE_TYPE |
The type of the profile is invalid. |
WLAN_REASON_CODE_INVALID_PHY_TYPE |
The PHY type is invalid. |
WLAN_REASON_CODE_MSM_SECURITY_MISSING |
The MSM security settings are missing. |
WLAN_REASON_CODE_IHV_SECURITY_NOT_SUPPORTED |
The independent hardware vendor (IHV) security settings are missing. |
WLAN_REASON_CODE_IHV_OUI_MISMATCH |
The IHV profile organizationally unique identifier (OUI) did not match with the adapter OUI. |
WLAN_REASON_CODE_IHV_OUI_MISSING |
The IHV OUI settings are missing. |
WLAN_REASON_CODE_IHV_SETTINGS_MISSING |
The IHV security settings are missing. |
WLAN_REASON_CODE_IHV_CONNECTIVITY_NOT_SUPPORTED |
Legacy MSM does not support IHV extensibility. |
WLAN_REASON_CODE_CONFLICT_SECURITY |
The security settings conflict. |
WLAN_REASON_CODE_SECURITY_MISSING |
The security settings are missing. |
WLAN_REASON_CODE_INVALID_BSS_TYPE |
The BSS type is not valid. |
WLAN_REASON_CODE_INVALID_ADHOC_CONNECTION_MODE |
Automatic connection cannot be set for an ad hoc network. |
WLAN_REASON_CODE_NON_BROADCAST_SET_FOR_ADHOC |
Non-broadcast cannot be set for an ad hoc network. |
WLAN_REASON_CODE_AUTO_SWITCH_SET_FOR_ADHOC |
Auto-switch cannot be set for an ad hoc network. |
WLAN_REASON_CODE_AUTO_SWITCH_SET_FOR_MANUAL_CONNECTION |
Auto-switch cannot be set for a manual connection profile. |
WLAN_REASON_CODE_IHV_SECURITY_ONEX_MISSING |
The IHV 802.1X security settings are missing. |
WLAN_REASON_CODE_PROFILE_SSID_INVALID |
The SSID in the profile is invalid or missing. |
WLAN_REASON_CODE_TOO_MANY_SSID |
Too many SSIDs were specified in the profile. |
| MSM Network Incompatibility Error Codes | Meaning |
|---|---|
WLAN_REASON_CODE_UNSUPPORTED_SECURITY_SET_BY_OS |
The security settings are not supported by the operating system. |
WLAN_REASON_CODE_UNSUPPORTED_SECURITY_SET |
The security settings are not supported. |
WLAN_REASON_CODE_BSS_TYPE_UNMATCH |
The BSS type does not match. |
WLAN_REASON_CODE_PHY_TYPE_UNMATCH |
The physical layer (PHY) type does not match. |
WLAN_REASON_CODE_DATARATE_UNMATCH |
The data rate does not match. |
| MSM Connection Failure Error Codes | Meaning |
|---|---|
WLAN_REASON_CODE_USER_CANCELLED |
User has canceled the operation. |
WLAN_REASON_CODE_ASSOCIATION_FAILURE |
Driver disconnected while associating. |
WLAN_REASON_CODE_ASSOCIATION_TIMEOUT |
Association timed out. |
WLAN_REASON_CODE_PRE_SECURITY_FAILURE |
Pre-association security failure. |
WLAN_REASON_CODE_START_SECURITY_FAILURE |
Could not start security after association. |
WLAN_REASON_CODE_SECURITY_FAILURE |
Security ends with failure. |
WLAN_REASON_CODE_SECURITY_TIMEOUT |
Security operation times out. |
WLAN_REASON_CODE_ROAMING_FAILURE |
Driver disconnected while roaming. |
WLAN_REASON_CODE_ROAMING_SECURITY_FAILURE |
Could not start security for roaming. |
WLAN_REASON_CODE_ADHOC_SECURITY_FAILURE |
Could not start security for ad hoc peer. |
WLAN_REASON_CODE_DRIVER_DISCONNECTED |
Driver disconnected. |
WLAN_REASON_CODE_DRIVER_OPERATION_FAILURE |
Driver could not perform some operations. |
WLAN_REASON_CODE_IHV_NOT_AVAILABLE |
The IHV service is not available. |
WLAN_REASON_CODE_IHV_NOT_RESPONDING |
The response from the IHV service timed out. |
WLAN_REASON_CODE_DISCONNECT_TIMEOUT |
Timed out waiting for the driver to disconnect. |
WLAN_REASON_CODE_INTERNAL_FAILURE |
An internal error prevented the operation from being completed. |
WLAN_REASON_CODE_UI_REQUEST_TIMEOUT |
A user interaction request timed out. |
WLAN_REASON_CODE_TOO_MANY_SECURITY_ATTEMPTS |
Roaming too frequently. Post security was not completed after 5 tries. |
| MSM Security Error Codes | Meaning |
|---|---|
WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_KEY_INDEX |
Key index specified is not valid. |
WLAN_REASON_CODE_MSMSEC_PROFILE_PSK_PRESENT |
Key required, preshared key (PSK) present. |
WLAN_REASON_CODE_MSMSEC_PROFILE_KEY_LENGTH |
Invalid key length. |
WLAN_REASON_CODE_MSMSEC_PROFILE_PSK_LENGTH |
Invalid PSK length. |
WLAN_REASON_CODE_MSMSEC_PROFILE_NO_AUTH_CIPHER_SPECIFIED |
No auth/cipher pairs specified. |
WLAN_REASON_CODE_MSMSEC_PROFILE_TOO_MANY_AUTH_CIPHER_SPECIFIED |
Too many auth/cipher pairs specified. |
WLAN_REASON_CODE_MSMSEC_PROFILE_DUPLICATE_AUTH_CIPHER |
Profile contains duplicate auth/cipher pair. |
WLAN_REASON_CODE_MSMSEC_PROFILE_RAWDATA_INVALID |
Profile raw data is invalid. |
WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_AUTH_CIPHER |
Invalid auth/cipher combination. |
WLAN_REASON_CODE_MSMSEC_PROFILE_ONEX_DISABLED |
802.1X disabled when it must be enabled. |
WLAN_REASON_CODE_MSMSEC_PROFILE_ONEX_ENABLED |
802.1X enabled when it must be disabled. |
WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PMKCACHE_MODE |
Invalid pairwise master key (PMK) cache mode. |
WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PMKCACHE_SIZE |
Invalid PMK cache size. |
WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PMKCACHE_TTL |
Invalid PMK cache Time to Live (TTL). |
WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PREAUTH_MODE |
Invalid preauthorization mode. |
WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PREAUTH_THROTTLE |
Invalid preauthorization throttle. |
WLAN_REASON_CODE_MSMSEC_PROFILE_PREAUTH_ONLY_ENABLED |
Preauth enabled when PMK cache is disabled. |
WLAN_REASON_CODE_MSMSEC_PROFILE_SAFE_MODE |
Federal Information Processing Standards (FIPS) 140-2 mode value in the profile is invalid. |
WLAN_REASON_CODE_MSMSEC_CAPABILITY_NETWORK |
Capability matching failed at network. |
WLAN_REASON_CODE_MSMSEC_CAPABILITY_NIC |
Capability matching failed at network adapter. |
WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE |
Capability matching failed at profile. |
WLAN_REASON_CODE_MSMSEC_CAPABILITY_DISCOVERY |
Network does not support specified capability type. |
WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE_SAFE_MODE_NIC |
Profile requires FIPS 140-2 mode, which is not supported by network adapter. |
WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE_SAFE_MODE_NW |
Profile requires FIPS 140-2 mode, which is not supported by network. |
WLAN_REASON_CODE_MSMSEC_PROFILE_PASSPHRASE_CHAR |
Passphrase contains invalid character. |
WLAN_REASON_CODE_MSMSEC_PROFILE_KEYMATERIAL_CHAR |
Key material contains invalid character. |
WLAN_REASON_CODE_MSMSEC_PROFILE_WRONG_KEYTYPE |
The key type specified does not match the key material. |
WLAN_REASON_CODE_MSMSEC_MIXED_CELL |
A mixed cell is suspected. The access point (AP) is not signaling that it is compatible with a privacy-enabled profile. |
WLAN_REASON_CODE_MSMSEC_PROFILE_AUTH_TIMERS_INVALID |
The number of authentication timers or the number of timeouts specified in the profile is invalid. |
WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_GKEY_INTV |
The group key update interval specified in the profile is invalid. |
WLAN_REASON_CODE_MSMSEC_TRANSITION_NETWORK |
A "transition network" is suspected. Legacy 802.11 security is used for the next authentication try. |
WLAN_REASON_CODE_MSMSEC_PROFILE_KEY_UNMAPPED_CHAR |
The key contains characters that are not in the ASCII character set. |
WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE_AUTH |
Capability matching failed because the network does not support the authentication method in the profile. |
WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE_CIPHER |
Capability matching failed because the network does not support the cipher algorithm in the profile. |
| MSM Connection Error Codes | Meaning |
|---|---|
WLAN_REASON_CODE_MSMSEC_AUTH_START_TIMEOUT |
802.1X authentication did not start within configured time. |
WLAN_REASON_CODE_MSMSEC_AUTH_SUCCESS_TIMEOUT |
802.1X authentication did not finish within configured time. |
WLAN_REASON_CODE_MSMSEC_KEY_START_TIMEOUT |
Dynamic key exchange did not start within configured time. |
WLAN_REASON_CODE_MSMSEC_KEY_SUCCESS_TIMEOUT |
Dynamic key exchange did not finish within configured time. |
WLAN_REASON_CODE_MSMSEC_M3_MISSING_KEY_DATA |
Message 3 of 4-way handshake has no key data. |
WLAN_REASON_CODE_MSMSEC_M3_MISSING_IE |
Message 3 of 4-way handshake has no information element. |
WLAN_REASON_CODE_MSMSEC_M3_MISSING_GRP_KEY |
Message 3 of 4-way handshake has no group (GRP) key. |
WLAN_REASON_CODE_MSMSEC_PR_IE_MATCHING |
Matching security capabilities of IE in M3 failed. |
WLAN_REASON_CODE_MSMSEC_SEC_IE_MATCHING |
Matching security capabilities of secondary IE in M3 failed. |
WLAN_REASON_CODE_MSMSEC_NO_PAIRWISE_KEY |
Required a pairwise key but the AP configured only group keys. |
WLAN_REASON_CODE_MSMSEC_G1_MISSING_KEY_DATA |
Message 1 of group key handshake has no key data. |
WLAN_REASON_CODE_MSMSEC_G1_MISSING_GRP_KEY |
Message 1 of group key handshake has no group key. |
WLAN_REASON_CODE_MSMSEC_PEER_INDICATED_INSECURE |
AP reset secure bit after connection was secured. |
WLAN_REASON_CODE_MSMSEC_NO_AUTHENTICATOR |
802.1X indicated that there is no authenticator, but the profile requires one. |
WLAN_REASON_CODE_MSMSEC_NIC_FAILURE |
Connection settings to network adapter failed. |
WLAN_REASON_CODE_MSMSEC_CANCELLED |
Operation was canceled by a caller. |
WLAN_REASON_CODE_MSMSEC_KEY_FORMAT |
Entered key format is not in a valid format. |
WLAN_REASON_CODE_MSMSEC_DOWNGRADE_DETECTED |
A security downgrade was detected. |
WLAN_REASON_CODE_MSMSEC_PSK_MISMATCH_SUSPECTED |
A PSK mismatch is suspected. |
WLAN_REASON_CODE_MSMSEC_FORCED_FAILURE |
There was a forced failure because the connection method was not secure. |
WLAN_REASON_CODE_MSMSEC_SECURITY_UI_FAILURE |
The security UI request failed because the request could not be queued or because the user canceled the request. |
| 802.1X Reason Codes | Meaning |
|---|---|
ONEX_UNABLE_TO_IDENTIFY_USER |
No user is available for 802.1X authentication. This error can occur when computer authentication is disabled and no user is logged on to the computer. |
ONEX_IDENTITY_NOT_FOUND |
The 802.1X identity could not be found. |
ONEX_UI_DISABLED |
Authentication could only be completed through the user interface and this interface could not be displayed. |
ONEX_EAP_FAILURE_RECEIVED |
The Extensible Authentication Protocol (EAP) authentication failed. |
ONEX_AUTHENTICATOR_NO_LONGER_PRESENT |
The 802.1X authenticator went away from the network. |
ONEX_PROFILE_VERSION_NOT_SUPPORTED |
The version of the OneX profile supplied is not supported. |
ONEX_PROFILE_INVALID_LENGTH |
The OneX profile has an invalid length. |
ONEX_PROFILE_DISALLOWED_EAP_TYPE |
The EAP type specified in the OneX profile (possibly supplied by the EAPType element) is not allowed. |
ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG |
The EAP Type specified in the OneX profile (possibly supplied by the EAPType element) is invalid, or one of the EAP flags (possibly supplied in the EAPConfig element) is invalid. |
ONEX_PROFILE_INVALID_ONEX_FLAGS |
The supplicant flags (possibly supplied in the EAPConfig element) in the OneX profile are invalid. |
ONEX_PROFILE_INVALID_TIMER_VALUE |
A timer specified in the OneX profile (possibly supplied by the heldPeriod, authPeriod, or startPeriod element) is invalid. |
ONEX_PROFILE_INVALID_SUPPLICANT_MODE |
The supplicant mode specified in the OneX profile (possibly supplied by the supplicantMode element) is invalid. |
ONEX_PROFILE_INVALID_AUTH_MODE |
The authentication mode specified in the OneX profile (possibly supplied by the authMode element) is invalid. |
ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES |
The connection properties specified in the OneX profile (possibly supplied by the EAPConfig element) are invalid. |
Remarks
You can use the WlanReasonCodeToString function to map a numeric reason code (for example, 0x00050007) to its text meaning. You can also use the lookup table to help interpret the numeric value of the reason code. To view the lookup table, open the Microsoft site Troubleshooting Windows Vista 802.11 Wireless Connections, and look in Appendix E: Mapping of reason codes to event messages.
See Also
Reference
Native Wi-Fi Structures
WlanReasonCodeToString
WlanSetProfile
Native Wi-Fi Reference