WLAN_REASON_CODE

WLAN_REASON_CODE类型指示 WLAN 操作失败的原因。

可以使用 WlanReasonCodeToString 函数将数字原因代码映射到 (,例如,0x00050007) 其文本含义。 还可以使用查阅表来帮助解释原因代码的数值。 若要查看查阅表格,请参阅附录 E:将原因代码映射到文档中的事件消息的映射,Windows Vista 802.11 无线连接故障排除。

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 配置文件中指定了过多的 SSID。
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 怀疑混合单元格。 美联社未表示它与已启用隐私的配置文件兼容。
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.11w 标准 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 不允许使用 EAPType 元素) 提供的 OneX 配置文件中指定的 EAP 类型 (。
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 (SP3) 以及 Windows具有 Service Pack 2 (SP2) 的无线 LAN API Windows 支持一组有限的原因代码。 WINDOWS XP 和 SP2 Windows XP 的无线 LAN API 支持的配置文件验证错误代码如下所示:

  • WLAN_REASON_CODE_INVALID_PROFILE_SCHEMA
  • WLAN_REASON_CODE_PROFILE_MISSING
  • WLAN_REASON_CODE_PROFILE_SSID_INVALID

WINDOWS XP 和 SP2 Windows XP 的无线 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 以及 SP2 Windows XP 的无线 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,使用 SP3 Windows XP [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]
可再发行组件
适用于 SP2 Windows XP 的无线 LAN API
标头
Wlanapi.h

另请参阅

WlanReasonCodeToString

WlanSetProfile