WiFiAdapter 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
注意
針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，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 WiFiAdapterPublic NotInheritable Class WiFiAdapter- 繼承
- 屬性
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 配接器上完成時引發的事件。 無法從背景工作引發此事件。 |