WLAN_HOSTED_NETWORK_REASON列舉 (wlanapi.h)

發行項
08/28/2023

WLAN_HOSTED_NETWORK_REASON列舉型別會指定無線託管網路函式呼叫結果的可能值。

Syntax

typedef enum _WLAN_HOSTED_NETWORK_REASON {
  wlan_hosted_network_reason_success = 0,
  wlan_hosted_network_reason_unspecified,
  wlan_hosted_network_reason_bad_parameters,
  wlan_hosted_network_reason_service_shutting_down,
  wlan_hosted_network_reason_insufficient_resources,
  wlan_hosted_network_reason_elevation_required,
  wlan_hosted_network_reason_read_only,
  wlan_hosted_network_reason_persistence_failed,
  wlan_hosted_network_reason_crypt_error,
  wlan_hosted_network_reason_impersonation,
  wlan_hosted_network_reason_stop_before_start,
  wlan_hosted_network_reason_interface_available,
  wlan_hosted_network_reason_interface_unavailable,
  wlan_hosted_network_reason_miniport_stopped,
  wlan_hosted_network_reason_miniport_started,
  wlan_hosted_network_reason_incompatible_connection_started,
  wlan_hosted_network_reason_incompatible_connection_stopped,
  wlan_hosted_network_reason_user_action,
  wlan_hosted_network_reason_client_abort,
  wlan_hosted_network_reason_ap_start_failed,
  wlan_hosted_network_reason_peer_arrived,
  wlan_hosted_network_reason_peer_departed,
  wlan_hosted_network_reason_peer_timeout,
  wlan_hosted_network_reason_gp_denied,
  wlan_hosted_network_reason_service_unavailable,
  wlan_hosted_network_reason_device_change,
  wlan_hosted_network_reason_properties_change,
  wlan_hosted_network_reason_virtual_station_blocking_use,
  wlan_hosted_network_reason_service_available_on_virtual_station
} WLAN_HOSTED_NETWORK_REASON, *PWLAN_HOSTED_NETWORK_REASON;

常數


`wlan_hosted_network_reason_success` 值： 0 作業成功。
`wlan_hosted_network_reason_unspecified` 未知的錯誤。
`wlan_hosted_network_reason_bad_parameters` 不正確的參數。例如，如果應用程式無法從正確的控制碼參考用戶端內容，則會傳回這個原因程式碼， (WlanOpenHandle 函式所傳回的控制碼) 。
`wlan_hosted_network_reason_service_shutting_down` 服務正在關閉。
`wlan_hosted_network_reason_insufficient_resources` 服務資源不足。
`wlan_hosted_network_reason_elevation_required` 這項作業需要提高許可權。
`wlan_hosted_network_reason_read_only` 嘗試寫入唯讀資料。
`wlan_hosted_network_reason_persistence_failed` 資料持續性失敗。
`wlan_hosted_network_reason_crypt_error` 發生密碼編譯錯誤。
`wlan_hosted_network_reason_impersonation` 使用者模擬失敗。
`wlan_hosted_network_reason_stop_before_start` 已建立不正確的函式呼叫序列。
`wlan_hosted_network_reason_interface_available` 無線介面已可供使用。
`wlan_hosted_network_reason_interface_unavailable` 無線介面無法使用。每當無線託管網路的網路狀態 wlan_hosted_network_unavailable時，無線託管網路函式會傳回此原因代碼。例如，如果網域上的群組原則停用無線託管網路，則無線託管網路的網路狀態會wlan_hosted_network_unavailable。在此情況下，對 WlanHostedNetworkStartUsing 或 WlanHostedNetworkForceStart 函式的任何呼叫都會傳回此原因程式碼。
`wlan_hosted_network_reason_miniport_stopped` 無線迷你埠驅動程式已停止託管網路。
`wlan_hosted_network_reason_miniport_started` 無線迷你埠驅動程式狀態已變更。
`wlan_hosted_network_reason_incompatible_connection_started` 已啟動不相容的連線。不相容的連線是指下列其中一種情況：主要月臺配接器上會啟動臨機操作無線連線。網路監視是由應用程式 (網路監視器在主要月臺配接器上啟動，例如，呼叫 WlanSetInterface 函式的) ，並將 OpCode 參數設定為 wlan_intf_opcode_current_operation_mode ，而 pData 參數指向包含 DOT11_OPERATION_MODE_NETWORK_MONITOR的 ULONG。無線連線會在主要月臺配接器上的 FIPS 安全模式中啟動。 FIPS 安全模式是在無線連線的設定檔中指定。如需詳細資訊，請參閱 FIPSMode 元素。當主要月臺介面卡上啟動時，Windows 會在軟體型無線存取點上停止無線裝載網路， (AP) 配接器。無線託管網路狀態的網路狀態會變成 wlan_hosted_network_unavailable。
`wlan_hosted_network_reason_incompatible_connection_stopped` 已停止不相容的連線。先前在主要月臺配接器上啟動的不相容連線 (wlan_hosted_network_reason_incompatible_connection_started) ，但不相容的連線已停止。如果先前因為啟動不相容的連線而停止無線託管網路，Windows 將不會自動重新開機無線託管網路。應用程式可以藉由呼叫 WlanHostedNetworkStartUsing 或 WlanHostedNetworkForceStart 函式，在 AP 介面卡上重新開機無線託管網路。
`wlan_hosted_network_reason_user_action` 明確使用者動作所造成的狀態變更。
`wlan_hosted_network_reason_client_abort` 用戶端中止所造成的狀態變更。
`wlan_hosted_network_reason_ap_start_failed` 無線託管網路的驅動程式無法啟動。
`wlan_hosted_network_reason_peer_arrived` 連線到無線託管網路的對等互連。
`wlan_hosted_network_reason_peer_departed` 與無線託管網路中斷連線的對等互連。
`wlan_hosted_network_reason_peer_timeout` 對等逾時。
`wlan_hosted_network_reason_gp_denied` 群組原則拒絕作業。
`wlan_hosted_network_reason_service_unavailable` 無線區域網路服務未執行。
`wlan_hosted_network_reason_device_change` 無線託管網路所使用的無線介面卡已變更。
`wlan_hosted_network_reason_properties_change` 無線託管網路的屬性已變更。
`wlan_hosted_network_reason_virtual_station_blocking_use` 虛擬月臺作用中且封鎖作業。
`wlan_hosted_network_reason_service_available_on_virtual_station` 虛擬月臺上提供相同的服務。

備註

WLAN_HOSTED_NETWORK_REASON列舉類型是新增的原生無線 API 擴充功能，可支援 Windows 7 和更新版本的無線託管網路。

WLAN_HOSTED_NETWORK_REASON列舉無線託管網路函式呼叫失敗的可能原因，或產生特定無線託管網路通知的原因。

在 Windows 7 和更新版本上，如果電腦上存在具有裝載網路功能的無線介面卡，作業系統就會安裝虛擬裝置。如果電腦具有單一無線網路介面卡，此虛擬裝置通常會在「網路連線資料夾」中顯示為「無線網路連線 2」，其裝置名稱為「Microsoft Virtual WiFi Miniport 配接器」。此虛擬裝置專門用於執行軟體存取點 (SoftAP) 連線，而且不會出現在 WlanEnumInterfaces 函式傳回的清單中。此虛擬裝置的存留期會系結至實體無線介面卡。如果實體無線介面卡已停用，也會移除此虛擬裝置。

規格需求


最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
標頭	wlanapi.h (包含 Wlanapi.h)