共用方式為


WLAN_HOSTED_NETWORK_REASON列舉 (wlanapi.h)

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。 在此情況下,對 WlanHostedNetworkStartUsingWlanHostedNetworkForceStart 函式的任何呼叫都會傳回此原因程式碼。
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 將不會自動重新開機無線託管網路。 應用程式可以藉由呼叫 WlanHostedNetworkStartUsingWlanHostedNetworkForceStart 函式,在 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)

另請參閱

WlanEnumInterfaces

WlanHostedNetworkForceStart

WlanHostedNetworkForceStop

WlanHostedNetworkInitSettings

WlanHostedNetworkQuerySecondaryKey

WlanHostedNetworkRefreshSecuritySettings

WlanHostedNetworkSetProperty

WlanHostedNetworkSetSecondaryKey

WlanHostedNetworkStartUsing

WlanHostedNetworkStopUsing