OnlineIdAuthenticator.AuthenticateUserAsync 方法

定义

命名空间:

Windows.Security.Authentication.OnlineId

重载

AuthenticateUserAsync(OnlineIdServiceTicketRequest)	如果需要收集凭据或同意并获取票证，请显示凭据提示，以一个 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)

如果需要收集凭据或同意并获取票证，请显示凭据提示，以一个 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

一个请求对象，它使应用能够指定用于对 Live 用户进行身份验证以获取标识属性和票证的服务和策略。

返回

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)