OnlineIdAuthenticator.AuthenticateUserAsync Método

Definição

Namespace:

Windows.Security.Authentication.OnlineId

Sobrecargas

AuthenticateUserAsync(OnlineIdServiceTicketRequest)

Inicia a solicitação de autenticação assíncrona com um OnlineIdServiceTicketRequest mostrando o prompt de credencial, se necessário, para coletar credenciais ou consentimento e obter o tíquete. Se um usuário estiver conectado a um sistema Windows 8 com uma conta Microsoft, esse usuário será usado para a solicitação de autenticação. Observação Se você estiver desenvolvendo para o Windows 10 ou superior, use as APIs Windows.Security.Authentication.Web.Core . Para obter mais informações, consulte Gerenciador de contas Web.

AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

Inicia a solicitação de autenticação assíncrona com vários OnlineIdServiceTicketRequests e fornece a capacidade de controlar a experiência do usuário definindo CredentialPromptType para obter os tíquetes. Se um usuário estiver conectado a um sistema Windows 8 com uma conta Microsoft, esse usuário será usado para a solicitação de autenticação. Observação Se você estiver desenvolvendo para o Windows 10 ou superior, use as APIs Windows.Security.Authentication.Web.Core . Para obter mais informações, consulte Gerenciador de contas Web.

AuthenticateUserAsync(OnlineIdServiceTicketRequest)

Inicia a solicitação de autenticação assíncrona com um OnlineIdServiceTicketRequest mostrando o prompt de credencial, se necessário, para coletar credenciais ou consentimento e obter o tíquete. Se um usuário estiver conectado a um sistema Windows 8 com uma conta Microsoft, esse usuário será usado para a solicitação de autenticação.

Observação

Se você estiver desenvolvendo para o Windows 10 ou superior, use as APIs Windows.Security.Authentication.Web.Core . Para obter mais informações, consulte Gerenciador de contas 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

Parâmetros

request

OnlineIdServiceTicketRequest

Um objeto de solicitação que fornece a capacidade de um aplicativo especificar o serviço e a política usados para autenticar um usuário do Live para obter propriedades de identidade e tíquetes.

Retornos

UserAuthenticationOperation

Um objeto que representa a operação de autenticação.

Atributos

OverloadAttribute

Comentários

Ao usar esses métodos, considere as seguintes diretrizes de tratamento de erros:

• Se a solicitação de autenticação assíncrona falhar, o erro será capturado no código de erro do objeto IAsyncInfo .
• Se as solicitações de autenticação assíncronas forem iniciadas e alguns dos tíquetes forem obtidos, mas alguns deles falharem, a resposta será S_OK.
• Se a solicitação de autenticação em si foi bem-sucedida, mas não foi possível solicitar tíquetes individuais, IAsyncInfo retornará S_OK mas OnlineIdServiceTicket.ErrorCode capturará códigos de erro de tíquete individuais.
• Se todas as solicitações de tíquete falharem, o IAsyncInfo conterá o código de erro real.
• Se todas as chamadas tiverem sido bem-sucedidas e todos os tíquetes tiverem sido obtidos com êxito, o código de erro será S_OK indicando que nenhum erro ocorreu.

Confira também

• AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

Inicia a solicitação de autenticação assíncrona com vários OnlineIdServiceTicketRequests e fornece a capacidade de controlar a experiência do usuário definindo CredentialPromptType para obter os tíquetes. Se um usuário estiver conectado a um sistema Windows 8 com uma conta Microsoft, esse usuário será usado para a solicitação de autenticação.

Observação

Se você estiver desenvolvendo para o Windows 10 ou superior, use as APIs Windows.Security.Authentication.Web.Core . Para obter mais informações, consulte Gerenciador de contas 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

Parâmetros

requests

IIterable<OnlineIdServiceTicketRequest>

IEnumerable<OnlineIdServiceTicketRequest>

Uma coleção de solicitações.

credentialPromptType

CredentialPromptType

O tipo de credenciais.

Retornos

UserAuthenticationOperation

Um objeto que representa a operação de autenticação.

Atributos

OverloadAttribute

Confira também

• AuthenticateUserAsync(OnlineIdServiceTicketRequest)