HotspotAuthenticationContext.IssueCredentialsAsync メソッド

定義

名前空間:

Windows.Networking.NetworkOperators

ホット スポット認証のために Windows に非同期的に資格情報を提供する Windows では、これらの資格情報はキャッシュされません。システムが同じホットスポットに再度接続すると、別の認証イベントが発生します。

これは 、IssueCredentials の非同期バージョンです。 同じパラメーターを受け取りますが、非同期操作は認証が完了したときにのみ完了します。 これに対し、認証が開始されるとすぐに IssueCredentials API が返されます。 このメソッドが完了すると、結果オブジェクトを調べて、認証試行の状態をチェックできます。

Note

この機能は、モバイル ネットワーク オペレーターによる特権アクセスを許可されたモバイル オペレーター アプリと 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