HotspotAuthenticationContext.IssueCredentialsAsync 方法

定義

命名空間:

Windows.Networking.NetworkOperators

以異步方式提供認證給 Windows 進行熱點驗證 Windows 不會快取這些認證，當系統再次連線到相同的熱點時，將會引發另一個驗證事件。

它是 IssueCredentials 的異步版本。 它會採用相同的參數，但異步操作只會在驗證完成時完成。 相反地， IssueCredentials API 會在驗證啟動時立即傳回。 完成此方法時，可能會檢查結果物件，以檢查驗證嘗試的狀態。

注意

這項功能僅適用於行動電信業者提供特殊許可權存取權的電信業者應用程式和UWP應用程式。

如果您想要使用此 API 並將您的應用程式發佈至 Microsoft Store，則需要特殊核准。 如需詳細資訊，請參閱應用程式功能宣告主題中的受限制功能一節。

public:
 virtual IAsyncOperation<HotspotCredentialsAuthenticationResult ^> ^ IssueCredentialsAsync(Platform::String ^ userName, Platform::String ^ password, Platform::String ^ extraParameters, bool markAsManualConnectOnFailure) = IssueCredentialsAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<HotspotCredentialsAuthenticationResult> IssueCredentialsAsync(winrt::hstring const& userName, winrt::hstring const& password, winrt::hstring const& extraParameters, bool const& markAsManualConnectOnFailure);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<HotspotCredentialsAuthenticationResult> IssueCredentialsAsync(string userName, string password, string extraParameters, bool markAsManualConnectOnFailure);

function issueCredentialsAsync(userName, password, extraParameters, markAsManualConnectOnFailure)

Public Function IssueCredentialsAsync (userName As String, password As String, extraParameters As String, markAsManualConnectOnFailure As Boolean) As IAsyncOperation(Of HotspotCredentialsAuthenticationResult)

參數

userName

String

Platform::String

winrt::hstring

無線網路服務提供者漫遊 (WISPr) 驗證通訊協定的 UserName 參數。 IssueCredentials 會在將值提交至伺服器之前執行 URL 編碼。 如果這個字串是空的，則會略過對應的驗證參數。

password

String

Platform::String

winrt::hstring

WISPr 驗證通訊協定的 Password 參數。 IssueCredentials 會在將值提交至伺服器之前執行 URL 編碼。 如果這個字串是空的，則會略過對應的驗證參數。

extraParameters

String

Platform::String

winrt::hstring

要附加至驗證字串的其他參數。 IssueCredentials 會在 “&” 字元後面附加此參數至 HTTP POST 字串，就像沒有編碼一樣。 這可用來新增多個參數。 此參數的預設值是空字串。

markAsManualConnectOnFailure

Boolean

bool

如果 為 true，應用程式會永久停用連線上的自動連線屬性。 如果驗證失敗，連線將會中斷連線，而不會在目前的用戶會話中重試。 否則為 false。

傳回

IAsyncOperation<HotspotCredentialsAuthenticationResult>

熱點驗證要求的結果。

屬性

RemoteAsyncAttribute

Windows 需求

應用程式功能

cellularDeviceControl cellularDeviceIdentity