OnlineIdAuthenticator.AuthenticateUserAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 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 プロパティとチケットを取得するライブ ユーザーの認証に使用されるサービスとポリシーを指定する機能を提供する要求オブジェクト。
戻り値
認証操作を表す オブジェクト。
- 属性
注釈
これらのメソッドを使用する場合は、次のエラー処理ガイドラインを考慮してください。
- 非同期認証要求が失敗した場合、エラーは IAsyncInfo オブジェクトのエラーコードにキャプチャされます。
- 非同期認証要求が開始され、一部のチケットが取得されたが、そのうちの一部が失敗した場合、応答はS_OK。
- 認証要求自体が成功したが、個々のチケットを要求できなかった場合、 IAsyncInfo はS_OKを返しますが、 OnlineIdServiceTicket.ErrorCode は個々のチケット エラー コードをキャプチャします。
- すべてのチケット要求が失敗した場合、 IAsyncInfo には実際のエラー コードが含まれます。
- すべての呼び出しが成功し、すべてのチケットが正常に取得された場合、エラーが発生しなかったかを示すエラー コードがS_OKされます。
こちらもご覧ください
適用対象
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パラメーター
要求のコレクション。
- credentialPromptType
- CredentialPromptType
資格情報の種類。
戻り値
認証操作を表す オブジェクト。
- 属性