语言

DevicePolicyManager.SetPasswordQuality(ComponentName, PasswordQuality) 方法

定义

由管理设备的应用程序调用,以设置其施加的密码限制。

[Android.Runtime.Register("setPasswordQuality", "(Landroid/content/ComponentName;I)V", "GetSetPasswordQuality_Landroid_content_ComponentName_IHandler")]
public virtual void SetPasswordQuality(Android.Content.ComponentName admin, Android.App.Admin.PasswordQuality quality);
[<Android.Runtime.Register("setPasswordQuality", "(Landroid/content/ComponentName;I)V", "GetSetPasswordQuality_Landroid_content_ComponentName_IHandler")>]
abstract member SetPasswordQuality : Android.Content.ComponentName * Android.App.Admin.PasswordQuality -> unit
override this.SetPasswordQuality : Android.Content.ComponentName * Android.App.Admin.PasswordQuality -> unit

参数

admin
ComponentName

DeviceAdminReceiver此请求与此请求相关联。

quality
PasswordQuality

新的所需质量。 之 #PASSWORD_QUALITY_UNSPECIFIED一、 #PASSWORD_QUALITY_BIOMETRIC_WEAK、、 #PASSWORD_QUALITY_SOMETHING、 #PASSWORD_QUALITY_NUMERIC、 #PASSWORD_QUALITY_NUMERIC_COMPLEX、、、 #PASSWORD_QUALITY_ALPHABETIC或 #PASSWORD_QUALITY_ALPHANUMERIC#PASSWORD_QUALITY_COMPLEX。

特性

注解

由管理设备的应用程序调用,以设置其施加的密码限制。 设置此设置后,用户将无法输入至少与已设置的密码一样限制的新密码。 请注意,当前密码将一直保留,直到用户设置了新密码,因此更改不会立即发生。 若要提示用户输入新密码,请使用 #ACTION_SET_NEW_PASSWORD 或 #ACTION_SET_NEW_PARENT_PROFILE_PASSWORD 调用此方法后。

对质量常量进行排序,以便提高值的限制性;因此,请求质量最高的常量(此处设置的策略、用户的首选项和任何其他注意事项之间)是有效的一个。

在不支持 PackageManager#FEATURE_SECURE_LOCK_SCREEN 功能的设备上,密码始终被视为空。

呼叫设备管理员必须请求 DeviceAdminInfo#USES_POLICY_LIMIT_PASSWORD 能够调用此方法;如果没有,将引发安全异常。

面向android.os.Build.VERSION_CODES#R和下面的应用可以对返回DevicePolicyManager的#getParentProfileInstance(ComponentName)实例调用此方法,以便对父配置文件设置限制。 面向及更高版本android.os.Build.VERSION_CODES#S的应用(除了组织拥有的设备上的配置文件所有者(如可以标识)#isOrganizationOwnedDeviceWithManagedProfile外,在父IllegalArgumentException实例上调用此方法时会获得一个DevicePolicyManager。

注意: 使用此方法指定密码要求可清除使用 #setRequiredPasswordComplexity(int)设置的密码复杂性要求。 如果在返回的DevicePolicyManager#getParentProfileInstance(ComponentName)实例上调用此方法,则必须首先通过调用 DevicePolicyManager#setRequiredPasswordComplexity#PASSWORD_COMPLEXITY_NONE) 清除对主数据库设置的密码复杂性要求。

<p><string>Note:</strong> this method is ignored on {PackageManager#FEATURE_AUTOMOTIVE automotive builds.

此成员已弃用。 首选使用 #setRequiredPasswordComplexity(int),需要满足平台定义的复杂级别的密码,而不是指定自定义密码要求。 设置自定义、过于复杂的密码要求会导致用户难以记住的密码,并且可能无法提供任何安全优势,因为 Android 使用硬件支持的限制来阻止设备屏幕锁的联机和脱机暴力破解。 公司拥有的设备(完全托管和组织拥有的托管配置文件设备)能够继续使用此方法,但建议 #setRequiredPasswordComplexity(int) 改用此方法。

Java文档android.app.admin.DevicePolicyManager.setPasswordQuality(android.content.ComponentName, int)。

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

适用于