通过

WiFiAdapter.ConnectAsync 方法

  • 参考

定义

命名空间:
Windows.Devices.WiFi

重载

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind)

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重要

此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 api 行为的 Wi-Fi 访问和位置。

使用指定的重新连接策略将此 Wi-Fi 设备连接到指定的网络。
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential)

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重要

此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 api 行为的 Wi-Fi 访问和位置。

使用指定的通行短语和重新连接策略将此 Wi-Fi 设备连接到指定的网络。
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String)

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重要

此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 api 行为的 Wi-Fi 访问和位置。

使用给定的通行短语和重新连接策略将此 Wi-Fi 设备连接到隐藏的网络。
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String, WiFiConnectionMethod)

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重要

此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 api 行为的 Wi-Fi 访问和位置。

使用给定的通行短语、连接方法和重新连接策略将此 Wi-Fi 设备连接到隐藏的网络。

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind)

编辑

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重要

此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 api 行为的 Wi-Fi 访问和位置。

使用指定的重新连接策略将此 Wi-Fi 设备连接到指定的网络。

public:
 virtual IAsyncOperation<WiFiConnectionResult ^> ^ ConnectAsync(WiFiAvailableNetwork ^ availableNetwork, WiFiReconnectionKind reconnectionKind) = ConnectAsync;
/// [Windows.Foundation.Metadata.Overload("ConnectAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<WiFiConnectionResult> ConnectAsync(WiFiAvailableNetwork const& availableNetwork, WiFiReconnectionKind const& reconnectionKind);
[Windows.Foundation.Metadata.Overload("ConnectAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<WiFiConnectionResult> ConnectAsync(WiFiAvailableNetwork availableNetwork, WiFiReconnectionKind reconnectionKind);
function connectAsync(availableNetwork, reconnectionKind)
Public Function ConnectAsync (availableNetwork As WiFiAvailableNetwork, reconnectionKind As WiFiReconnectionKind) As IAsyncOperation(Of WiFiConnectionResult)

参数

availableNetwork
WiFiAvailableNetwork

描述要连接的 Wi-Fi 网络。

reconnectionKind
WiFiReconnectionKind

指定在连接丢失时如何重新连接。

返回

IAsyncOperation<WiFiConnectionResult>

异步连接操作。 操作成功完成后，返回描述连接操作结果的 对象。

属性
OverloadAttribute RemoteAsyncAttribute

另请参阅

适用于

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential)

编辑

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重要

此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 api 行为的 Wi-Fi 访问和位置。

使用指定的通行短语和重新连接策略将此 Wi-Fi 设备连接到指定的网络。

public:
 virtual IAsyncOperation<WiFiConnectionResult ^> ^ ConnectAsync(WiFiAvailableNetwork ^ availableNetwork, WiFiReconnectionKind reconnectionKind, PasswordCredential ^ passwordCredential) = ConnectAsync;
/// [Windows.Foundation.Metadata.Overload("ConnectWithPasswordCredentialAsync")]
IAsyncOperation<WiFiConnectionResult> ConnectAsync(WiFiAvailableNetwork const& availableNetwork, WiFiReconnectionKind const& reconnectionKind, PasswordCredential const& passwordCredential);
[Windows.Foundation.Metadata.Overload("ConnectWithPasswordCredentialAsync")]
public IAsyncOperation<WiFiConnectionResult> ConnectAsync(WiFiAvailableNetwork availableNetwork, WiFiReconnectionKind reconnectionKind, PasswordCredential passwordCredential);
function connectAsync(availableNetwork, reconnectionKind, passwordCredential)
Public Function ConnectAsync (availableNetwork As WiFiAvailableNetwork, reconnectionKind As WiFiReconnectionKind, passwordCredential As PasswordCredential) As IAsyncOperation(Of WiFiConnectionResult)

参数

availableNetwork
WiFiAvailableNetwork

指定要连接到 Wi-Fi 网络。

reconnectionKind
WiFiReconnectionKind

介绍如何在连接断开时重新连接到网络。

passwordCredential
PasswordCredential

用于连接到接入点的通行短语。

返回

IAsyncOperation<WiFiConnectionResult>

异步连接操作。 操作成功完成后，返回描述连接操作结果的 对象。

属性
OverloadAttribute

另请参阅

适用于

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String)

编辑

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重要

此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。

使用给定的通行短语和重新连接策略将此 Wi-Fi 设备连接到隐藏的网络。

public:
 virtual IAsyncOperation<WiFiConnectionResult ^> ^ ConnectAsync(WiFiAvailableNetwork ^ availableNetwork, WiFiReconnectionKind reconnectionKind, PasswordCredential ^ passwordCredential, Platform::String ^ ssid) = ConnectAsync;
/// [Windows.Foundation.Metadata.Overload("ConnectWithPasswordCredentialAndSsidAsync")]
IAsyncOperation<WiFiConnectionResult> ConnectAsync(WiFiAvailableNetwork const& availableNetwork, WiFiReconnectionKind const& reconnectionKind, PasswordCredential const& passwordCredential, winrt::hstring const& ssid);
[Windows.Foundation.Metadata.Overload("ConnectWithPasswordCredentialAndSsidAsync")]
public IAsyncOperation<WiFiConnectionResult> ConnectAsync(WiFiAvailableNetwork availableNetwork, WiFiReconnectionKind reconnectionKind, PasswordCredential passwordCredential, string ssid);
function connectAsync(availableNetwork, reconnectionKind, passwordCredential, ssid)
Public Function ConnectAsync (availableNetwork As WiFiAvailableNetwork, reconnectionKind As WiFiReconnectionKind, passwordCredential As PasswordCredential, ssid As String) As IAsyncOperation(Of WiFiConnectionResult)

参数

availableNetwork
WiFiAvailableNetwork

描述要连接到 Wi-Fi 网络。

reconnectionKind
WiFiReconnectionKind

介绍如何在连接断开时重新连接到网络。

passwordCredential
PasswordCredential

用于连接到网络的密码或其他凭据。

ssid
String

Platform::String

winrt::hstring

当网络 SSID 处于隐藏状态时，请使用此参数提供 SSID。

返回

IAsyncOperation<WiFiConnectionResult>

异步连接操作。 操作成功完成后，返回描述连接操作结果的 对象。

属性
OverloadAttribute

另请参阅

适用于

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String, WiFiConnectionMethod)

编辑

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重要

此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 Wi-Fi 访问和位置的 API 行为。

使用给定的通行短语、连接方法和重新连接策略将此 Wi-Fi 设备连接到隐藏的网络。

public:
 virtual IAsyncOperation<WiFiConnectionResult ^> ^ ConnectAsync(WiFiAvailableNetwork ^ availableNetwork, WiFiReconnectionKind reconnectionKind, PasswordCredential ^ passwordCredential, Platform::String ^ ssid, WiFiConnectionMethod connectionMethod) = ConnectAsync;
/// [Windows.Foundation.Metadata.Overload("ConnectWithPasswordCredentialAndSsidAndConnectionMethodAsync")]
IAsyncOperation<WiFiConnectionResult> ConnectAsync(WiFiAvailableNetwork const& availableNetwork, WiFiReconnectionKind const& reconnectionKind, PasswordCredential const& passwordCredential, winrt::hstring const& ssid, WiFiConnectionMethod const& connectionMethod);
[Windows.Foundation.Metadata.Overload("ConnectWithPasswordCredentialAndSsidAndConnectionMethodAsync")]
public IAsyncOperation<WiFiConnectionResult> ConnectAsync(WiFiAvailableNetwork availableNetwork, WiFiReconnectionKind reconnectionKind, PasswordCredential passwordCredential, string ssid, WiFiConnectionMethod connectionMethod);
function connectAsync(availableNetwork, reconnectionKind, passwordCredential, ssid, connectionMethod)
Public Function ConnectAsync (availableNetwork As WiFiAvailableNetwork, reconnectionKind As WiFiReconnectionKind, passwordCredential As PasswordCredential, ssid As String, connectionMethod As WiFiConnectionMethod) As IAsyncOperation(Of WiFiConnectionResult)

参数

availableNetwork
WiFiAvailableNetwork

指定要连接到 Wi-Fi 网络。

reconnectionKind
WiFiReconnectionKind

指定在连接丢失时如何重新连接。

passwordCredential
PasswordCredential

用于连接到接入点的通行短语。

ssid
String

Platform::String

winrt::hstring

当网络 SSID 隐藏时，使用此参数提供 SSID。

connectionMethod
WiFiConnectionMethod

指示连接方法的 WiFiConnectionMethod 枚举成员。

返回

IAsyncOperation<WiFiConnectionResult>

异步连接操作。 成功完成操作后，返回描述连接操作结果的 对象。

属性
OverloadAttribute

Windows 要求

设备系列
Windows 10 Fall Creators Update (在 10.0.16299.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v5.0 中引入)

另请参阅

适用于