共用方式為


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 設定檔中指定了太多 SSD。
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 無線區域網路 需要管理畫面格保護 (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 不允許在 OneX 設定檔中指定的 EAP 類型 (EAPType 元素) 。
ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG 在 OneX 設定檔中指定的 EAP 類型 (EAPType 元素) 可能無效,或 EAPConfig 元素中可能提供的其中一個 EAP 旗標) (無效。
ONEX_PROFILE_INVALID_ONEX_FLAGS 在 OneX 設定檔的 EAPConfig 元素) 中,可能提供 (的 supplicant 旗標無效。
ONEX_PROFILE_INVALID_TIMER_VALUE OneX 設定檔中指定的計時器 (可能由 heldPeriod、authPeriod 或 startPeriod 元素提供,) 無效。
ONEX_PROFILE_INVALID_SUPPLICANT_MODE 在 OneX 設定檔中指定的 supplicant 模式 (可能由 supplicantMode 元素提供) 無效。
ONEX_PROFILE_INVALID_AUTH_MODE 在 OneX 設定檔中指定的驗證模式 (可能由 authMode 元素提供,) 無效。
ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES 在 OneX 設定檔中指定的連接屬性 (可能由 EAPConfig 元素提供) 無效。

 

備註

Windows XP 搭配 Service Pack 3 (SP3) ,以及適用于 Windows XP 的無線區域網路 API (SP2) 支援一組有限的原因代碼。 Windows XP SP3 和 Windows XP SP2 無線區域網路 API 上支援的設定檔驗證錯誤碼如下所示:

  • WLAN_REASON_CODE_INVALID_PROFILE_SCHEMA
  • WLAN_REASON_CODE_PROFILE_MISSING
  • WLAN_REASON_CODE_PROFILE_SSID_INVALID

Windows XP SP3 和 Windows XP SP2 無線區域網路 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

Windows XP SP3 和 Windows XP SP2 無線區域網路 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 [僅限傳統型應用程式]
可轉散發套件
適用于 Windows XP 與 SP2 的無線區域網路 API
標頭
Wlanapi.h

另請參閱

WlanReasonCodeToString

WlanSetProfile