WLAN_REASON_CODE
WLAN_REASON_CODE类型指示 WLAN 操作失败的原因。
可以使用 WlanReasonCodeToString 函数将数字原因代码映射到 (例如，0x00050007) 其文本含义。 还可以使用查阅表格来帮助解释原因代码的数值。 若要查看查阅表格，请参阅 Windows Vista 802.11 无线连接疑难解答文档中的附录 E：将原因代码映射到事件消息。
typedef DWORD WLAN_REASON_CODE, *PWLAN_REASON_CODE;
下表列出了常规错误代码。
| 原因代码 | 含义 |
|---|---|
| WLAN_REASON_CODE_SUCCESS | 操作成功。 |
| WLAN_REASON_CODE_UNKNOWN | 失败的原因未知。 |
下表列出了自动配置错误代码。
| 原因代码 | 含义 |
|---|---|
| WLAN_REASON_CODE_NETWORK_NOT_COMPATIBLE | 无线网络不兼容。 |
| WLAN_REASON_CODE_PROFILE_NOT_COMPATIBLE | 无线网络配置文件不兼容。 |
下表列出了自动连接错误代码。
| 原因代码 | 含义 |
|---|---|
| WLAN_REASON_CODE_NO_AUTO_CONNECTION | 配置文件不指定任何自动连接。 |
| WLAN_REASON_CODE_NOT_VISIBLE | 无线网络不可见。 |
| WLAN_REASON_CODE_GP_DENIED | 无线网络被组策略阻止。 |
| WLAN_REASON_CODE_USER_DENIED | 无线网络被用户阻止。 |
| WLAN_REASON_CODE_BSS_TYPE_NOT_ALLOWED | 此无线适配器上不允许 (BSS) 类型的基本服务集。 |
| WLAN_REASON_CODE_IN_FAILED_LIST | 无线网络位于失败列表中。 |
| WLAN_REASON_CODE_IN_BLOCKED_LIST | 无线网络在阻止列表中。 |
| WLAN_REASON_CODE_SSID_LIST_TOO_LONG | SSID) 列表 (服务集标识符的大小超出了适配器支持的最大大小。 |
| WLAN_REASON_CODE_CONNECT_CALL_FAIL | 媒体特定模块 (MSM) 连接调用失败。 |
| WLAN_REASON_CODE_SCAN_CALL_FAIL | MSM 扫描调用失败。 |
| WLAN_REASON_CODE_NETWORK_NOT_AVAILABLE | 指定的网络不可用。当 XML 配置文件中指定的功能与接口和/或网络功能之间存在不匹配时，也会使用此原因代码。 例如，如果配置文件指定在 NIC 仅支持 WPA 时使用 WPA2，则返回此错误代码。 此外，如果配置文件指定在 NIC 不支持 FIPS 模式时使用 FIPS 模式，则返回此错误代码。 |
| WLAN_REASON_CODE_PROFILE_CHANGED_OR_DELETED | 在建立连接之前，配置文件已更改或删除。 |
| WLAN_REASON_CODE_KEY_MISMATCH | 配置文件密钥与网络密钥不匹配。 |
| WLAN_REASON_CODE_USER_NOT_RESPOND | 用户未响应。 |
| WLAN_REASON_CODE_AP_PROFILE_NOT_ALLOWED_FOR_CLIENT | 应用程序尝试使用 WlanSetProfile 函数将无线托管网络配置文件应用到物理无线网络适配器，而不是应用于虚拟设备。 |
| WLAN_REASON_CODE_AP_PROFILE_NOT_ALLOWED | 应用程序尝试使用 WlanSetProfile 函数将无线托管网络配置文件应用到物理无线网络适配器，而不是应用于虚拟设备。 |
下表列出了配置文件验证错误代码。
| 原因代码 | 含义 |
|---|---|
| WLAN_REASON_CODE_INVALID_PROFILE_SCHEMA | 根据架构，配置文件无效。 |
| WLAN_REASON_CODE_PROFILE_MISSING | 缺少 WLANProfile 元素。 |
| WLAN_REASON_CODE_INVALID_PROFILE_NAME | 配置文件的名称无效。 |
| WLAN_REASON_CODE_INVALID_PROFILE_TYPE | 配置文件的类型无效。 |
| WLAN_REASON_CODE_INVALID_PHY_TYPE | PHY 类型无效。 |
| WLAN_REASON_CODE_MSM_SECURITY_MISSING | 缺少 MSM 安全设置。 |
| WLAN_REASON_CODE_IHV_SECURITY_NOT_SUPPORTED | 缺少 IHV) 安全设置 (独立硬件供应商。 |
| WLAN_REASON_CODE_IHV_OUI_MISMATCH | IHV 配置文件 OUI 与适配器 OUI 不匹配。 |
| WLAN_REASON_CODE_IHV_OUI_MISSING | 缺少 IHV OUI 设置。 |
| WLAN_REASON_CODE_IHV_SETTINGS_MISSING | 缺少 IHV 安全设置。 |
| WLAN_REASON_CODE_IHV_CONNECTIVITY_NOT_SUPPORTED | 应用程序尝试在不支持 IHV 连接设置的适配器上应用 IHV 配置文件。 |
| WLAN_REASON_CODE_CONFLICT_SECURITY | 安全设置冲突。 |
| WLAN_REASON_CODE_SECURITY_MISSING | 缺少安全设置。 |
| WLAN_REASON_CODE_INVALID_BSS_TYPE | BSS 类型无效。 |
| WLAN_REASON_CODE_INVALID_ADHOC_CONNECTION_MODE | 无法为即席网络设置自动连接。 |
| WLAN_REASON_CODE_NON_BROADCAST_SET_FOR_ADHOC | 不能为临时网络设置非广播。 |
| WLAN_REASON_CODE_AUTO_SWITCH_SET_FOR_ADHOC | 无法为临时网络设置自动切换。 |
| WLAN_REASON_CODE_AUTO_SWITCH_SET_FOR_MANUAL_CONNECTION | 无法为手动连接配置文件设置自动切换。 |
| WLAN_REASON_CODE_IHV_SECURITY_ONEX_MISSING | 缺少 IHV 802.1X 安全设置。 |
| WLAN_REASON_CODE_PROFILE_SSID_INVALID | 配置文件中的 SSID 无效或缺失。 |
| WLAN_REASON_CODE_TOO_MANY_SSID | 配置文件中指定的 SSSD 过多。 |
| WLAN_REASON_CODE_IHV_CONNECTIVITY_NOT_SUPPORTED | |
| WLAN_REASON_CODE_BAD_MAX_NUMBER_OF_CLIENTS_FOR_AP | 应用程序尝试使用 WlanSetProfile 函数将无线托管网络配置文件应用到物理网络适配器 NIC，并为允许的最大客户端数指定了不可接受的值。 |
| WLAN_REASON_CODE_INVALID_CHANNEL | 指定的通道无效。 |
| WLAN_REASON_CODE_OPERATION_MODE_NOT_SUPPORTED | |
| WLAN_REASON_CODE_AUTO_AP_PROFILE_NOT_ALLOWED | 无线托管网络出现内部操作系统错误。 |
| WLAN_REASON_CODE_AUTO_CONNECTION_NOT_ALLOWED |
下表列出了 MSM 网络不兼容错误代码。
| 原因代码 | 含义 |
|---|---|
| WLAN_REASON_CODE_UNSUPPORTED_SECURITY_SET_BY_OS | 操作系统不支持安全设置。 |
| WLAN_REASON_CODE_UNSUPPORTED_SECURITY_SET | 不支持安全设置。 |
| WLAN_REASON_CODE_BSS_TYPE_UNMATCH | BSS 类型不匹配。 |
| WLAN_REASON_CODE_PHY_TYPE_UNMATCH | PHY 类型不匹配。 |
| WLAN_REASON_CODE_DATARATE_UNMATCH | 数据速率不匹配。 |
下表列出了 MSM 连接失败错误代码。
| 原因代码 | 含义 |
|---|---|
| WLAN_REASON_CODE_USER_CANCELLED | 用户已取消操作。 |
| WLAN_REASON_CODE_ASSOCIATION_FAILURE | 驱动程序在关联时断开连接。 |
| WLAN_REASON_CODE_ASSOCIATION_TIMEOUT | 关联超时。 |
| WLAN_REASON_CODE_PRE_SECURITY_FAILURE | 关联前安全失败。 |
| WLAN_REASON_CODE_START_SECURITY_FAILURE | 关联后未能启动安全性。 |
| WLAN_REASON_CODE_SECURITY_FAILURE | 安全性最终会失败。 |
| WLAN_REASON_CODE_SECURITY_TIMEOUT | 安全操作超时。 |
| WLAN_REASON_CODE_ROAMING_FAILURE | 驱动程序在漫游时断开连接。 |
| WLAN_REASON_CODE_ROAMING_SECURITY_FAILURE | 无法启动漫游的安全性。 |
| WLAN_REASON_CODE_ADHOC_SECURITY_FAILURE | 无法启动临时对等方的安全性。 |
| WLAN_REASON_CODE_DRIVER_DISCONNECTED | 驱动程序已断开连接。 |
| WLAN_REASON_CODE_DRIVER_OPERATION_FAILURE | 驱动程序无法执行某些操作。 |
| WLAN_REASON_CODE_IHV_NOT_AVAILABLE | IHV 服务不可用。 |
| WLAN_REASON_CODE_IHV_NOT_RESPONDING | 来自 IHV 服务的响应超时。 |
| WLAN_REASON_CODE_DISCONNECT_TIMEOUT | 等待驱动程序断开连接时超时。 |
| WLAN_REASON_CODE_INTERNAL_FAILURE | 内部错误阻止操作完成。 |
| WLAN_REASON_CODE_UI_REQUEST_TIMEOUT | 用户交互请求超时。 |
| WLAN_REASON_CODE_TOO_MANY_SECURITY_ATTEMPTS | 漫游过于频繁。 5 次尝试后未完成安全发布。 |
| WLAN_REASON_CODE_AP_STARTING_FAILURE | 发生内部操作系统错误，导致无法启动无线托管网络。 |
下表列出了 MSM 安全错误代码。
| 原因代码 | 含义 |
|---|---|
| WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_KEY_INDEX | 指定的键索引无效。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_PSK_PRESENT | 密钥是必需的，PSK 存在。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_KEY_LENGTH | 密钥长度无效。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_PSK_LENGTH | PSK 长度无效。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_NO_AUTH_CIPHER_SPECIFIED | 未指定身份验证/密码对。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_TOO_MANY_AUTH_CIPHER_SPECIFIED | 指定的身份验证/密码对过多。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_DUPLICATE_AUTH_CIPHER | 配置文件包含重复的身份验证/密码对。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_RAWDATA_INVALID | 配置文件原始数据无效。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_AUTH_CIPHER | 身份验证/密码组合无效。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_ONEX_DISABLED | 802.1X 在需要启用时已禁用。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_ONEX_ENABLED | 需要禁用时启用 802.1X。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PMKCACHE_MODE | 无效的 PMK 缓存模式。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PMKCACHE_SIZE | 无效的 PMK 缓存大小。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PMKCACHE_TTL | 无效的 PMK 缓存 TTL。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PREAUTH_MODE | 预身份验证模式无效。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_PREAUTH_THROTTLE | 预身份验证限制无效。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_PREAUTH_ONLY_ENABLED | 禁用 PMK 缓存时启用预身份验证。 |
| WLAN_REASON_CODE_MSMSEC_CAPABILITY_NETWORK | 网络的功能匹配失败。 |
| WLAN_REASON_CODE_MSMSEC_CAPABILITY_NIC | NIC 的功能匹配失败。 |
| WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE | 配置文件的功能匹配失败。 |
| WLAN_REASON_CODE_MSMSEC_CAPABILITY_DISCOVERY | 网络不支持指定的功能类型。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_PASSPHRASE_CHAR | 通行短语包含无效字符。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_KEYMATERIAL_CHAR | 密钥材料包含无效字符。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_WRONG_KEYTYPE | 指定的键类型与密钥材料不匹配。 |
| WLAN_REASON_CODE_MSMSEC_MIXED_CELL | 怀疑是混合细胞。 AP 没有表示它与启用了隐私的配置文件兼容。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_AUTH_TIMERS_INVALID | 身份验证计时器数或配置文件中指定的超时次数无效。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_GKEY_INTV | 配置文件中指定的组密钥更新间隔无效。 |
| WLAN_REASON_CODE_MSMSEC_TRANSITION_NETWORK | 怀疑存在“过渡网络”。 旧版 802.11 安全性用于下一次身份验证尝试。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_KEY_UNMAPPED_CHAR | 键包含不在 ASCII 字符集中的字符。 |
| WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE_AUTH | 功能匹配失败，因为网络不支持配置文件中的身份验证方法。 |
| WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE_CIPHER | 功能匹配失败，因为网络不支持配置文件中的密码算法。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_SAFE_MODE | 配置文件中的 FIPS 140-2 模式值无效。 |
| WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE_SAFE_MODE_NIC | 配置文件需要 FIPS 140-2 模式，而网络接口卡 (NIC) 不支持该模式。 |
| WLAN_REASON_CODE_MSMSEC_CAPABILITY_PROFILE_SAFE_MODE_NW | 配置文件需要 FIPS 140-2 模式，网络不支持该模式。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_UNSUPPORTED_AUTH | 配置文件指定不受支持的身份验证 、机制。 |
| WLAN_REASON_CODE_MSMSEC_PROFILE_UNSUPPORTED_CIPHER | 配置文件指定不受支持的密码。 |
| WLAN_REASON_CODE_MSMSEC_UI_REQUEST_FAILURE | 未能将用户界面请求排队。 |
| WLAN_REASON_CODE_MSMSEC_CAPABILITY_MFP_NW_NIC | 无线 LAN 需要管理帧保护 (MFP) ，并且网络接口不支持 MFP。 有关详细信息，请参阅 802.11 标准的 IEEE 802.11w 修正案。 |
下表列出了 MSM 连接错误代码。
| 原因代码 | 含义 |
|---|---|
| WLAN_REASON_CODE_MSMSEC_AUTH_START_TIMEOUT | 802.1X 身份验证未在配置的时间内启动。 |
| WLAN_REASON_CODE_MSMSEC_AUTH_SUCCESS_TIMEOUT | 802.1X 身份验证未在配置的时间内完成。 |
| WLAN_REASON_CODE_MSMSEC_KEY_START_TIMEOUT | 动态密钥交换未在配置的时间内启动。 |
| WLAN_REASON_CODE_MSMSEC_KEY_SUCCESS_TIMEOUT | 动态密钥交换未在配置的时间内完成。 |
| WLAN_REASON_CODE_MSMSEC_M3_MISSING_KEY_DATA | 4 向握手的消息 3 没有关键数据。 |
| WLAN_REASON_CODE_MSMSEC_M3_MISSING_IE | 4 向握手的消息 3 没有 IE。 |
| WLAN_REASON_CODE_MSMSEC_M3_MISSING_GRP_KEY | 4 向握手的消息 3 没有 GRP 密钥。 |
| WLAN_REASON_CODE_MSMSEC_PR_IE_MATCHING | 匹配 M3 中 IE 的安全功能失败。 |
| WLAN_REASON_CODE_MSMSEC_SEC_IE_MATCHING | M3 中辅助 IE 的安全功能匹配失败。 |
| WLAN_REASON_CODE_MSMSEC_NO_PAIRWISE_KEY | 需要成对密钥，但接入点 (AP) 仅配置组密钥。 |
| WLAN_REASON_CODE_MSMSEC_G1_MISSING_KEY_DATA | 组键握手的消息 1 没有密钥数据。 |
| WLAN_REASON_CODE_MSMSEC_G1_MISSING_GRP_KEY | 组密钥握手的消息 1 没有组键。 |
| WLAN_REASON_CODE_MSMSEC_PEER_INDICATED_INSECURE | 连接安全后 AP 重置安全位。 |
| WLAN_REASON_CODE_MSMSEC_NO_AUTHENTICATOR | 802.1X 指示没有验证器，但配置文件需要验证器。 |
| WLAN_REASON_CODE_MSMSEC_NIC_FAILURE | NIC 的管道设置失败。 |
| WLAN_REASON_CODE_MSMSEC_CANCELLED | 操作已被调用方取消。 |
| WLAN_REASON_CODE_MSMSEC_KEY_FORMAT | 输入的密钥格式不是有效的格式。 |
| WLAN_REASON_CODE_MSMSEC_DOWNGRADE_DETECTED | 检测到安全降级。 |
| WLAN_REASON_CODE_MSMSEC_PSK_MISMATCH_SUSPECTED | 怀疑 PSK 不匹配。 |
| WLAN_REASON_CODE_MSMSEC_FORCED_FAILURE | 由于连接方法不安全，导致强制失败。 |
| WLAN_REASON_CODE_MSMSEC_M3_TOO_MANY_RSNIE | 4 路握手的消息 3 包含过多 RSN IE (RSN) 。 |
| WLAN_REASON_CODE_MSMSEC_M2_MISSING_KEY_DATA | 4 路握手的消息 2 没有 (RSN Adhoc) 的关键数据。 |
| WLAN_REASON_CODE_MSMSEC_M2_MISSING_IE | 4 路握手的消息 2 没有 IE (RSN adhoc) 。 |
| WLAN_REASON_CODE_MSMSEC_AUTH_WCN_COMPLETED | |
| WLAN_REASON_CODE_MSMSEC_SECURITY_UI_FAILURE | 安全 UI 请求失败，因为请求无法排队或用户取消了请求。 |
| WLAN_REASON_CODE_MSMSEC_M3_MISSING_MGMT_GRP_KEY | 4 路握手的消息 3 没有 Mgmt 组密钥 (RSN) 。 |
| WLAN_REASON_CODE_MSMSEC_G1_MISSING_MGMT_GRP_KEY | 组密钥握手的消息 1 没有组管理密钥。 |
下表列出了 802.1X 原因代码。 下面命名的架构元素在 OneX 架构中定义，并在 WLAN 配置文件中指定。
| 原因代码 | 含义 |
|---|---|
| ONEX_UNABLE_TO_IDENTIFY_USER | 没有用户可用于 802.1X 身份验证。 禁用计算机身份验证且没有用户登录到计算机时，可能会发生此错误。 |
| ONEX_IDENTITY_NOT_FOUND | 找不到 802.1X 标识。 |
| ONEX_UI_DISABLED | 只能通过用户界面完成身份验证，并且无法显示此界面。 |
| ONEX_EAP_FAILURE_RECEIVED | EAP 身份验证失败。 |
| ONEX_AUTHENTICATOR_NO_LONGER_PRESENT | 802.1X 验证器已离开网络。 |
| ONEX_PROFILE_VERSION_NOT_SUPPORTED | 不支持提供的 OneX 配置文件版本。 |
| ONEX_PROFILE_INVALID_LENGTH | OneX 配置文件的长度无效。 |
| ONEX_PROFILE_DISALLOWED_EAP_TYPE | 不允许使用 OneX 配置文件中指定的 EAP 类型 (可能由 EAPType 元素提供，) 。 |
| ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG | OneX 配置文件中指定的 EAP 类型 (可能由 EAPType 元素提供，) 无效，或者 EAPConfig 元素中 (可能提供的 EAP 标志之一) 无效。 |
| ONEX_PROFILE_INVALID_ONEX_FLAGS | 可能 (OneX 配置文件中的 EAPConfig 元素) 中提供的请求标志无效。 |
| ONEX_PROFILE_INVALID_TIMER_VALUE | OneX 配置文件中指定的计时器 (可能由 heldPeriod、authPeriod 或 startPeriod 元素提供，) 无效。 |
| ONEX_PROFILE_INVALID_SUPPLICANT_MODE | OneX 配置文件中指定的请求模式 (可能由 supplicantMode 元素提供的) 无效。 |
| ONEX_PROFILE_INVALID_AUTH_MODE | OneX 配置文件中指定的身份验证模式 (可能由 authMode 元素提供的) 无效。 |
| ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES | OneX 配置文件中指定的连接属性 (可能由 EAPConfig 元素提供，) 无效。 |
备注
具有 Service Pack 3 的 Windows XP (SP3) 以及 Windows XP 的无线 LAN API with Service Pack 2 (SP2) 支持一组有限的原因代码。 Windows XP SP3 和 Windows XP SP2 无线 LAN API 支持的配置文件验证错误代码如下所示：
- WLAN_REASON_CODE_INVALID_PROFILE_SCHEMA
- WLAN_REASON_CODE_PROFILE_MISSING
- WLAN_REASON_CODE_PROFILE_SSID_INVALID
带 SP3 的 Windows XP 和 Windows XP SP2 的无线 LAN API 支持的 MSM 安全错误代码如下所示：
- WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_KEY_INDEX
- WLAN_REASON_CODE_MSMSEC_PROFILE_KEY_LENGTH
- WLAN_REASON_CODE_MSMSEC_PROFILE_PSK_LENGTH
- WLAN_REASON_CODE_MSMSEC_PROFILE_INVALID_AUTH_CIPHER
- WLAN_REASON_CODE_MSMSEC_PROFILE_ONEX_DISABLED
- WLAN_REASON_CODE_MSMSEC_PROFILE_ONEX_ENABLED
- WLAN_REASON_CODE_MSMSEC_CAPABILITY_NETWORK
- WLAN_REASON_CODE_MSMSEC_CAPABILITY_NIC
- WLAN_REASON_CODE_MSMSEC_PROFILE_KEYMATERIAL_CHAR
- WLAN_REASON_CODE_MSMSEC_PROFILE_WRONG_KEYTYPE
带 SP3 的 Windows XP 和 Windows XP SP2 的无线 LAN API 支持的 802.1x 错误代码如下所示：
- ONEX_PROFILE_INVALID_LENGTH
- ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG
- ONEX_PROFILE_INVALID_AUTH_MODE
- ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista、Windows XP SP3 [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
| 可再发行组件 |
带有 SP2 的 Windows XP 无线 LAN API |
| 标头 |
|
请参阅