AccountManager.UpdateCredentials Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Pide al usuario que escriba una nueva contraseña para una cuenta y actualice las credenciales guardadas de la cuenta.
[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
Cuenta para la que se van a actualizar las credenciales
- authTokenType
- String
Las credenciales especificadas deben permitir que se cree un token de autenticación de este tipo (pero no se devuelve ningún token de autenticación real); puede ser null
- options
- Bundle
Opciones específicas del autenticador para la solicitud; puede ser null o estar vacío
- activity
- Activity
Contexto Activity que se va a usar para iniciar una nueva sub-actividad definida por el autenticador para pedir al usuario que escriba una contraseña; se usa solo para llamar a startActivity(); si es null, el símbolo del sistema no se iniciará directamente, pero lo necesario Intent se devolverá al autor de la llamada en su lugar.
- callback
- IAccountManagerCallback
Devolución de llamada para invocar cuando se completa la solicitud, null para ninguna devolución de llamada
- handler
- Handler
Handler identificar el subproceso de devolución de llamada, null para el subproceso principal
Devoluciones
Que AccountManagerFuture se resuelve en un paquete con estos campos si se proporcionó una actividad y las credenciales de la cuenta se actualizaron correctamente: <ul><li#KEY_ACCOUNT_NAME> - el nombre de la cuenta <li>#KEY_ACCOUNT_TYPE - el tipo de la cuenta </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
Comentarios
Pide al usuario que escriba una nueva contraseña para una cuenta y actualice las credenciales guardadas de la cuenta. Normalmente esto sucede automáticamente cuando el servidor rechaza las credenciales durante una captura de token de autenticación, pero esto se puede invocar directamente para asegurarse de que tenemos almacenadas las credenciales correctas.
Se puede llamar a este método desde cualquier subproceso, pero no se debe usar el devuelto en el subproceso AccountManagerFuture principal.
<b>NOTA:</b> Si el destino de la aplicación funciona en el nivel de API 22 y antes, se necesita MANAGE_ACCOUNTS permiso para esas plataformas. Consulte la documentación de esta función en el nivel de API 22.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.