OnlineIdAuthenticator.AuthenticateUserAsync メソッド

定義

名前空間:

Windows.Security.Authentication.OnlineId

オーバーロード

AuthenticateUserAsync(OnlineIdServiceTicketRequest)	資格情報または同意を収集してチケットを取得するために必要な場合は、資格情報プロンプトを表示して、1 つの OnlineIdServiceTicketRequest で非同期認証要求を開始します。 ユーザーが Microsoft アカウントを使用して Windows 8 システムにサインインしている場合、このユーザーは認証要求に使用されます。 注意 Windows 10以上の開発を行う場合は、代わりに Windows.Security.Authentication.Web.Core API を使用してください。 詳細については、「 Web アカウント マネージャー」を参照してください。
AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)	複数の OnlineIdServiceTicketRequests を使用して非同期認証要求を開始し、 CredentialPromptType を設定してチケットを取得することでユーザー エクスペリエンスを制御する機能を提供します。 ユーザーが Microsoft アカウントを使用して Windows 8 システムにサインインしている場合、このユーザーは認証要求に使用されます。 注意 Windows 10以上の開発を行う場合は、代わりに Windows.Security.Authentication.Web.Core API を使用してください。 詳細については、「 Web アカウント マネージャー」を参照してください。

AuthenticateUserAsync(OnlineIdServiceTicketRequest)

資格情報または同意を収集してチケットを取得するために必要な場合は、資格情報プロンプトを表示して、1 つの OnlineIdServiceTicketRequest で非同期認証要求を開始します。 ユーザーが Microsoft アカウントを使用して Windows 8 システムにサインインしている場合、このユーザーは認証要求に使用されます。

注意

Windows 10以上の開発を行う場合は、代わりに Windows.Security.Authentication.Web.Core API を使用してください。 詳細については、「 Web アカウント マネージャー」を参照してください。

public:
 virtual UserAuthenticationOperation ^ AuthenticateUserAsync(OnlineIdServiceTicketRequest ^ request) = AuthenticateUserAsync;

/// [Windows.Foundation.Metadata.Overload("AuthenticateUserAsync")]
UserAuthenticationOperation AuthenticateUserAsync(OnlineIdServiceTicketRequest const& request);

[Windows.Foundation.Metadata.Overload("AuthenticateUserAsync")]
public UserAuthenticationOperation AuthenticateUserAsync(OnlineIdServiceTicketRequest request);

function authenticateUserAsync(request)

Public Function AuthenticateUserAsync (request As OnlineIdServiceTicketRequest) As UserAuthenticationOperation

パラメーター

request

OnlineIdServiceTicketRequest

アプリが Id プロパティとチケットを取得するライブ ユーザーの認証に使用されるサービスとポリシーを指定する機能を提供する要求オブジェクト。

戻り値

UserAuthenticationOperation

認証操作を表す オブジェクト。

属性

OverloadAttribute

注釈

これらのメソッドを使用する場合は、次のエラー処理ガイドラインを考慮してください。

• 非同期認証要求が失敗した場合、エラーは IAsyncInfo オブジェクトのエラーコードにキャプチャされます。
• 非同期認証要求が開始され、一部のチケットが取得されたが、そのうちの一部が失敗した場合、応答はS_OK。
• 認証要求自体が成功したが、個々のチケットを要求できなかった場合、 IAsyncInfo はS_OKを返しますが、 OnlineIdServiceTicket.ErrorCode は個々のチケット エラー コードをキャプチャします。
• すべてのチケット要求が失敗した場合、 IAsyncInfo には実際のエラー コードが含まれます。
• すべての呼び出しが成功し、すべてのチケットが正常に取得された場合、エラーが発生しなかったかを示すエラー コードがS_OKされます。

こちらもご覧ください

• AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

複数の OnlineIdServiceTicketRequests を使用して非同期認証要求を開始し、 CredentialPromptType を設定してチケットを取得することでユーザー エクスペリエンスを制御する機能を提供します。 ユーザーが Microsoft アカウントを使用して Windows 8 システムにサインインしている場合、このユーザーは認証要求に使用されます。

注意

Windows 10以上の開発を行う場合は、代わりに Windows.Security.Authentication.Web.Core API を使用してください。 詳細については、「 Web アカウント マネージャー」を参照してください。

public:
 virtual UserAuthenticationOperation ^ AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest ^> ^ requests, CredentialPromptType credentialPromptType) = AuthenticateUserAsync;

/// [Windows.Foundation.Metadata.Overload("AuthenticateUserAsyncAdvanced")]
UserAuthenticationOperation AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest> const& requests, CredentialPromptType const& credentialPromptType);

[Windows.Foundation.Metadata.Overload("AuthenticateUserAsyncAdvanced")]
public UserAuthenticationOperation AuthenticateUserAsync(IEnumerable<OnlineIdServiceTicketRequest> requests, CredentialPromptType credentialPromptType);

function authenticateUserAsync(requests, credentialPromptType)

Public Function AuthenticateUserAsync (requests As IEnumerable(Of OnlineIdServiceTicketRequest), credentialPromptType As CredentialPromptType) As UserAuthenticationOperation

パラメーター

requests

IIterable<OnlineIdServiceTicketRequest>

IEnumerable<OnlineIdServiceTicketRequest>

要求のコレクション。

credentialPromptType

CredentialPromptType

資格情報の種類。

戻り値

UserAuthenticationOperation

認証操作を表す オブジェクト。

属性

OverloadAttribute

こちらもご覧ください

• AuthenticateUserAsync(OnlineIdServiceTicketRequest)