AccountManager.UpdateCredentials Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Solicita que o usuário insira uma nova senha para uma conta, atualizando as credenciais salvas para a conta.
[Android.Runtime.Register("updateCredentials", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetUpdateCredentials_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_Landroid_app_Activity_Landroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_ACCOUNTS")]
public virtual Android.Accounts.IAccountManagerFuture? UpdateCredentials(Android.Accounts.Account? account, string? authTokenType, Android.OS.Bundle? options, Android.App.Activity? activity, Android.Accounts.IAccountManagerCallback? callback, Android.OS.Handler? handler);
[<Android.Runtime.Register("updateCredentials", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetUpdateCredentials_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_Landroid_app_Activity_Landroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_ACCOUNTS")>]
abstract member UpdateCredentials : Android.Accounts.Account * string * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
override this.UpdateCredentials : Android.Accounts.Account * string * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
Parâmetros
- account
- Account
A conta para a qual atualizar as credenciais
- authTokenType
- String
As credenciais inseridas devem permitir que um token de autenticação desse tipo seja criado (mas nenhum token de autenticação real é retornado); pode ser nulo
- options
- Bundle
Opções específicas do autenticador para a solicitação; pode ser nulo ou vazio
- activity
- Activity
O Activity contexto a ser usado para iniciar uma nova sub-atividade definida pelo autenticador para solicitar que o usuário insira uma senha; usada apenas para chamar startActivity(); se for nulo, o prompt não será iniciado diretamente, mas o necessário Intent será retornado ao chamador.
- callback
- IAccountManagerCallback
Retorno de chamada a ser invocado quando a solicitação for concluída, nulo para nenhum retorno de chamada
- handler
- Handler
Handler identificando o thread de retorno de chamada, nulo para o thread principal
Retornos
Um AccountManagerFuture que é resolvido para um Pacote com esses campos se uma atividade foi fornecida e as credenciais da conta foram atualizadas com êxito: <ul><li>#KEY_ACCOUNT_NAME - o nome da conta <li>#KEY_ACCOUNT_TYPE - o tipo da conta </ul>
If no activity was specified, the returned Bundle contains
<code data-dev-comment-type="c">#KEY_INTENT</code> with the <code data-dev-comment-type="c">Intent</code> needed to launch the
password prompt. If an error occurred,
<code data-dev-comment-type="c">AccountManagerFuture#getResult()</code> throws:
<ul>
<li> <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
<li> <code data-dev-comment-type="c">OperationCanceledException</code> if the operation was canceled for
any reason, including the user canceling the password prompt
<li> <code data-dev-comment-type="c">IOException</code> if the authenticator experienced an I/O problem
verifying the password, usually because of network trouble
</ul>
- Atributos
Comentários
Solicita que o usuário insira uma nova senha para uma conta, atualizando as credenciais salvas para a conta. Normalmente, isso acontece automaticamente quando o servidor rejeita credenciais durante uma busca de token de autenticação, mas isso pode ser invocado diretamente para garantir que tenhamos as credenciais corretas armazenadas.
Esse método pode ser chamado de qualquer thread, mas o retornado AccountManagerFuture não deve ser usado no thread principal.
<b>OBSERVAÇÃO:</b> Se o destino do aplicativo funcionar no nível 22 da API e antes, MANAGE_ACCOUNTS permissão será necessária para essas plataformas. Consulte documentos para essa função no nível 22 da API.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.