AccountManager.ConfirmCredentials 方法

定义

确认用户知道帐户的密码,以确保他们是帐户的所有者。

[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.

        &lt;p&gt;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:
        &lt;ul&gt;
        &lt;li&gt; <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
        &lt;li&gt; <code data-dev-comment-type="c">OperationCanceledException</code> if the operation was canceled for
             any reason, including the user canceling the password prompt
        &lt;li&gt; <code data-dev-comment-type="c">IOException</code> if the authenticator experienced an I/O problem
             verifying the password, usually because of network trouble
        &lt;/ul&gt;
属性

注解

确认用户知道帐户的密码,以确保他们是帐户的所有者。 可以直接提供用户输入的密码,否则此帐户类型的验证器会提示用户使用相应的界面。 此方法适用于需要额外保证的应用程序;例如,手机锁屏使用此屏幕让用户使用帐户密码解锁手机(如果他们忘记了锁定模式)。

如果用户输入的密码与此帐户的已保存密码匹配,则请求被视为有效;否则,验证器会验证密码(通常是通过联系服务器)。

此方法可以从任何线程调用,但返回 AccountManagerFuture 的不能在主线程上使用。

<b>注意:</b> 如果面向应用在 API 级别 22 及之前工作,则需要这些平台MANAGE_ACCOUNTS权限。 请参阅 API 级别 22 中此函数的文档。

适用于 . 的 android.accounts.AccountManager.confirmCredentials(android.accounts.Account, android.os.Bundle, android.app.Activity, android.accounts.AccountManagerCallback<android.os.Bundle>, android.os.Handler)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于