AccountManager.ConfirmCredentials 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
确认用户知道帐户的密码,以确保他们是帐户的所有者。
[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
参数
- account
- Account
用于确认其密码知识的帐户
- options
- Bundle
请求的特定于验证器的选项; #KEY_PASSWORD
如果字符串字段存在,验证器可能会直接使用它,而不是提示用户;可能为 null 或为空
- activity
- Activity
Activity
用于启动新的验证器定义的子活动以提示用户输入密码的上下文;仅用于调用 startActivity();如果为 null,则不会直接启动提示,但需要Intent
改为返回到调用方
- callback
- IAccountManagerCallback
请求完成时要调用的回调,无回调为 null
- handler
- Handler
Handler
标识回调线程,主线程为 null
返回
AccountManagerFuture
如果提供了活动或密码,并且帐户已成功验证,则解析为包含这些字段的捆绑包:<ul><li>#KEY_ACCOUNT_NAME
- 验证的帐户名称 li#KEY_ACCOUNT_TYPE
> - 帐户 <<li>#KEY_BOOLEAN_RESULT
的类型 - true 以指示成功 </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>
- 属性
注解
确认用户知道帐户的密码,以确保他们是帐户的所有者。 可以直接提供用户输入的密码,否则此帐户类型的验证器会提示用户使用相应的界面。 此方法适用于需要额外保证的应用程序;例如,手机锁屏使用此屏幕让用户使用帐户密码解锁手机(如果他们忘记了锁定模式)。
如果用户输入的密码与此帐户的已保存密码匹配,则请求被视为有效;否则,验证器会验证密码(通常是通过联系服务器)。
此方法可以从任何线程调用,但返回 AccountManagerFuture
的不能在主线程上使用。
<b>注意:</b> 如果面向应用在 API 级别 22 及之前工作,则需要这些平台MANAGE_ACCOUNTS权限。 请参阅 API 级别 22 中此函数的文档。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。