AccountManager.ConfirmCredentials Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Confirme que l’utilisateur connaît le mot de passe d’un compte pour s’assurer qu’il est le propriétaire du compte.
[Android.Runtime.Register("confirmCredentials", "(Landroid/accounts/Account;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetConfirmCredentials_Landroid_accounts_Account_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? ConfirmCredentials (Android.Accounts.Account? account, Android.OS.Bundle? options, Android.App.Activity? activity, Android.Accounts.IAccountManagerCallback? callback, Android.OS.Handler? handler);
[<Android.Runtime.Register("confirmCredentials", "(Landroid/accounts/Account;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetConfirmCredentials_Landroid_accounts_Account_Landroid_os_Bundle_Landroid_app_Activity_Landroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_ACCOUNTS")>]
abstract member ConfirmCredentials : Android.Accounts.Account * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
override this.ConfirmCredentials : Android.Accounts.Account * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
Paramètres
- account
- Account
Compte pour confirmer la connaissance du mot de passe
- options
- Bundle
Options spécifiques à l’authentificateur pour la demande ; si le #KEY_PASSWORD
champ de chaîne est présent, l’authentificateur peut l’utiliser directement plutôt que d’inviter l’utilisateur ; peut être null ou vide.
- activity
- Activity
Contexte Activity
à utiliser pour lancer une nouvelle sous-activité définie par l’authentificateur pour inviter l’utilisateur à entrer un mot de passe ; utilisé uniquement pour appeler startActivity() ; si la valeur null n’est pas lancée directement, mais celle-ci Intent
sera renvoyée à l’appelant à la place.
- callback
- IAccountManagerCallback
Rappel à appeler une fois la requête terminée, null pour aucun rappel
- handler
- Handler
Handler
identification du thread de rappel, null pour le thread principal
Retours
Résolution AccountManagerFuture
d’un bundle avec ces champs si l’activité ou le mot de passe a été fourni et que le compte a été vérifié avec succès : <ul<>li#KEY_ACCOUNT_NAME
> - le nom du compte vérifié <li#KEY_ACCOUNT_TYPE
> - le type du compte <li>#KEY_BOOLEAN_RESULT
- true pour indiquer la réussite </ul>
If no activity or password 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.
<p>Also the returning Bundle may contain <code data-dev-comment-type="c">#KEY_LAST_AUTHENTICATED_TIME</code> indicating the last time the
credential was validated/created.
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>
- Attributs
Remarques
Confirme que l’utilisateur connaît le mot de passe d’un compte pour s’assurer qu’il est le propriétaire du compte. Le mot de passe entré par l’utilisateur peut être fourni directement, sinon l’authentificateur pour ce type de compte invite l’utilisateur à utiliser l’interface appropriée. Cette méthode est destinée aux applications qui souhaitent une assurance supplémentaire ; par exemple, l’écran de verrouillage du téléphone utilise cette option pour permettre à l’utilisateur de déverrouiller le téléphone avec un mot de passe de compte s’ils oublient le modèle de verrouillage.
Si le mot de passe entré par l’utilisateur correspond à un mot de passe enregistré pour ce compte, la demande est considérée comme valide ; sinon, l’authentificateur vérifie le mot de passe (généralement en contactant le serveur).
Cette méthode peut être appelée à partir de n’importe quel thread, mais elle AccountManagerFuture
ne doit pas être utilisée sur le thread principal.
<b>REMARQUE :</b> Si vous ciblez votre application pour travailler sur le niveau d’API 22 et avant, MANAGE_ACCOUNTS autorisation est nécessaire pour ces plateformes. Consultez la documentation de cette fonction dans le niveau 22 de l’API.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.