语言

DevicePolicyManager.ResetPasswordWithToken 方法

定义

由设备或配置文件所有者调用,以强制对当前用户设置新的设备解锁密码或托管配置文件质询。

[Android.Runtime.Register("resetPasswordWithToken", "(Landroid/content/ComponentName;Ljava/lang/String;[BI)Z", "GetResetPasswordWithToken_Landroid_content_ComponentName_Ljava_lang_String_arrayBIHandler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_RESET_PASSWORD")]
public virtual bool ResetPasswordWithToken(Android.Content.ComponentName? admin, string? password, byte[]? token, Android.App.Admin.ResetPasswordFlags flags);
[<Android.Runtime.Register("resetPasswordWithToken", "(Landroid/content/ComponentName;Ljava/lang/String;[BI)Z", "GetResetPasswordWithToken_Landroid_content_ComponentName_Ljava_lang_String_arrayBIHandler", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_RESET_PASSWORD")>]
abstract member ResetPasswordWithToken : Android.Content.ComponentName * string * byte[] * Android.App.Admin.ResetPasswordFlags -> bool
override this.ResetPasswordWithToken : Android.Content.ComponentName * string * byte[] * Android.App.Admin.ResetPasswordFlags -> bool

参数

admin
ComponentName

DeviceAdminReceiver此请求与此请求相关联。 如果调用方不是设备管理员,则为 Null。

password
String

用户的新密码。 null 或空清除密码。

token
Byte[]

以前由 #setResetPasswordToken. 预配的密码重置令牌。

flags
ResetPasswordFlags

可以是 0 或组合 #RESET_PASSWORD_REQUIRE_ENTRY 和 #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT。

返回

如果应用了密码,则返回 true;如果当前约束不可接受,则返回 false。

特性

注解

由设备或配置文件所有者调用,以强制对当前用户设置新的设备解锁密码或托管配置文件质询。 这会立即生效。

与此 API 不同 #resetPassword,即使在解锁或解密用户或设备之前,此 API 也可以更改密码。 提供的令牌必须以前通过 #setResetPasswordToken且处于活动状态 #isResetPasswordTokenActive进行预配。

给定的密码必须足以满足所返回#getPasswordQuality(ComponentName)#getPasswordMinimumLength(ComponentName)的当前密码质量和长度约束;如果它不符合这些约束,则将被拒绝并返回 false。 请注意,密码质量可能更强,例如,当请求的质量仅为数字时,包含字母数字字符的密码。

如果当前密码限制允许,则使用 null 或空密码进行调用将清除任何现有的 PIN、模式或密码。

在不支持 PackageManager#FEATURE_SECURE_LOCK_SCREEN 此功能的设备上,调用此方法不起作用 -- 密码始终为空 ,并返回 false。

Java文档android.app.admin.DevicePolicyManager.resetPasswordWithToken(android.content.ComponentName, java.lang.String, byte[], int)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于