WiFiAdapter.ConnectAsync 方法

參考

定義

命名空間:: Windows.Devices.WiFi

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

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 裝置連線到隱藏的網路，並使用指定的複雜密碼、連線方法，以及重新連線原則。

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind)

編輯

注意

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

重要

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

使用指定的重新連線原則，將此 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 年 2024 年。如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。

使用指定的複雜密碼和重新連線原則，將此 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 年 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 年 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 引進)

另請參閱

適用於

共用方式為

WiFiAdapter.ConnectAsync 方法

定義

多載

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind)

參數

傳回

另請參閱

適用於

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential)

參數

傳回

另請參閱

適用於

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String)

參數

傳回

另請參閱

適用於

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

參數

傳回

Windows 需求

另請參閱

適用於

意見反應

意見反應

其他資源