WiFiAdapter 类

定义

命名空间:

Windows.Devices.WiFi

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，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 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 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 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 适配器上完成扫描时引发的事件。 无法从后台任务引发此事件。