WiFiAdapter 類別

定義

命名空間:

Windows.Devices.WiFi

注意

針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。

重要

此 API 將受到即將變更作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。

使用這個類別來列舉本機 Wi-Fi 配接器、起始 Wi-Fi 掃描、列舉掃描結果，以及連接或中斷個別介面卡的連線或中斷連線。

public ref class WiFiAdapter sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiAdapter final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiAdapter

Public NotInheritable Class WiFiAdapter

繼承

Object Platform::Object IInspectable WiFiAdapter

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

您的程式碼會使用這個類別的靜態方法。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1709	16299	ConnectAsync (WiFiAvailableNetwork，WiFiReconnectionKind，PasswordCredential，String，WiFiConnectionMethod)
1709	16299	GetWpsConfigurationAsync

屬性

NetworkAdapter	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 取得 Wi-Fi 配接器的相關資訊。
NetworkReport	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 取得此 WiFiNetworkAdapter 上最後一次 Wi-Fi 掃描所填入的可用網路清單。

方法

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind)	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 使用指定的重新連線原則，將此 Wi-Fi 裝置連線到指定的網路。
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential)	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 使用指定的複雜密碼和重新連線原則，將此 Wi-Fi 裝置連線到指定的網路。
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String)	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 使用指定的複雜密碼和重新連線原則，將此 Wi-Fi 裝置連線到隱藏的網路。
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String, WiFiConnectionMethod)	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 使用指定的複雜密碼、連線方法和重新連線原則，將此 Wi-Fi 裝置連線到隱藏的網路。
Disconnect()	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 透過此配接器中斷任何作用中 Wi-Fi 連線。
FindAllAdaptersAsync()	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 靜態方法，起始非同步作業以列舉系統中所有 Wi-Fi 配接器。 請注意，如果您未指定應用程式在應用程式資訊清單中有 wiFiControl 功能，此方法就會失敗。
FromIdAsync(String)	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 靜態方法，起始非同步作業以取得 WiFiAdapter 物件。 請注意，如果您未指定應用程式在應用程式資訊清單中有 wiFiControl 功能，此方法就會失敗。
GetDeviceSelector()	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 靜態方法，會傳回進階查詢語法 (AQS) 字串，以用來列舉 使用 Windows.Devices.Enumeration.DeviceInformation.FindAllAsync 和相關方法 Wi-Fi 配接器。
GetWpsConfigurationAsync(WiFiAvailableNetwork)	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 執行 WPS 探索以查詢網路支援的 WPS 方法。
RequestAccessAsync()	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 用來判斷目前使用者是否可以存取此裝置上任何 Wi-Fi 介面卡的靜態方法。 請注意，如果您未指定應用程式在應用程式資訊清單中具有 wiFiControl 功能，這個方法一律會傳回 DeniedBySystem。 一律會傳回 Xbox 上的 DeniedBySystem 。
ScanAsync()	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 指示此配接器起始非同步網路掃描。

事件

AvailableNetworksChanged

注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 當掃描在此 Wi-Fi 配接器上完成時引發的事件。 無法從背景工作引發此事件。