WiFiAdapter 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
注意
一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重要
此 API 将受到即将于 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 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 获取有关 Wi-Fi 适配器的信息。 |
| NetworkReport |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 获取此 WiFiNetworkAdapter 上的最后一个 Wi-Fi 扫描填充的可用网络的列表。 |
方法
| ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind) |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 使用指定的重新连接策略将此 Wi-Fi 设备连接到指定的网络。 |
| ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential) |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 使用指定的通行短语和重新连接策略将此 Wi-Fi 设备连接到指定的网络。 |
| ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String) |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 使用给定的通行短语和重新连接策略将此 Wi-Fi 设备连接到隐藏的网络。 |
| ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String, WiFiConnectionMethod) |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 使用给定的通行短语、连接方法和重新连接策略将此 Wi-Fi 设备连接到隐藏的网络。 |
| Disconnect() |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 断开通过此适配器的任何活动 Wi-Fi 连接。 |
| FindAllAdaptersAsync() |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 一种静态方法，用于启动异步操作以枚举系统中的所有 Wi-Fi 适配器。 请注意，如果未在应用清单中指定应用具有 wiFiControl 功能，此方法将失败。 |
| FromIdAsync(String) |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 一种静态方法，用于启动异步操作以获取 WiFiAdapter 对象。 请注意，如果未在应用清单中指定应用具有 wiFiControl 功能，此方法将失败。 |
| GetDeviceSelector() |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 返回高级查询语法 (AQS) 字符串的静态方法，用于使用 Windows.Devices.Enumeration.DeviceInformation.FindAllAsync 和相关方法枚举 Wi-Fi 适配器。 |
| GetWpsConfigurationAsync(WiFiAvailableNetwork) |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 执行 WPS 发现以查询网络支持的 WPS 方法。 |
| RequestAccessAsync() |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 一种静态方法，用于确定当前用户是否可以访问此设备上的任何 Wi-Fi 适配器。 请注意，如果未在应用清单中指定应用具有 wiFiControl 功能，此方法始终返回 DeniedBySystem。 始终在 Xbox 上返回 DeniedBySystem 。 |
| ScanAsync() |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 指示此适配器启动异步网络扫描。 |
事件
| AvailableNetworksChanged |
注意 一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。 重要 此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。 在此 Wi-Fi 适配器上完成扫描时引发的事件。 无法从后台任务引发此事件。 |