DevicePolicyManager.SetMaximumFailedPasswordsForWipe 方法

定义

命名空间:

Android.App.Admin

程序集:

Mono.Android.dll

如果将此值设置为大于零的值，则会在输入过多不正确的设备解锁密码后执行设备或配置文件擦除的策略。

[Android.Runtime.Register("setMaximumFailedPasswordsForWipe", "(Landroid/content/ComponentName;I)V", "GetSetMaximumFailedPasswordsForWipe_Landroid_content_ComponentName_IHandler")]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_WIPE_DATA")]
public virtual void SetMaximumFailedPasswordsForWipe (Android.Content.ComponentName? admin, int num);

[<Android.Runtime.Register("setMaximumFailedPasswordsForWipe", "(Landroid/content/ComponentName;I)V", "GetSetMaximumFailedPasswordsForWipe_Landroid_content_ComponentName_IHandler")>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_WIPE_DATA")>]
abstract member SetMaximumFailedPasswordsForWipe : Android.Content.ComponentName * int -> unit
override this.SetMaximumFailedPasswordsForWipe : Android.Content.ComponentName * int -> unit

参数

admin

ComponentName

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

num

Int32

擦除设备或配置文件时失败的密码尝试次数。

属性

RegisterAttribute RequiresPermissionAttribute

注解

如果将此值设置为大于零的值，则会在输入过多不正确的设备解锁密码后执行设备或配置文件擦除的策略。 此策略结合了监视失败的密码和擦除设备，并要求调用设备管理员请求和 DeviceAdminInfo#USES_POLICY_WATCH_LOGINDeviceAdminInfo#USES_POLICY_WIPE_DATA}。

当在系统或主用户上设置此策略时，设备将在尝试太多错误密码后恢复出厂设置。 在任何其他用户上设置时，只会擦除相应的用户或配置文件。

若要实现任何其他策略（例如仅擦除特定应用程序的数据、擦除或撤销凭据或向服务器报告失败），应改为实现 DeviceAdminReceiver#onPasswordFailed(Context, android.content.Intent) 。 请勿使用此 API，因为如果达到最大计数，设备或配置文件将立即擦除，并且不会调用回调。

可以在返回#getParentProfileInstance(ComponentName)的DevicePolicyManager实例上调用此方法，以便对父配置文件设置值。

在不支持 PackageManager#FEATURE_SECURE_LOCK_SCREEN 功能的设备上，密码始终为空，此方法不起作用，即未设置策略。

适用于 . 的 android.app.admin.DevicePolicyManager.setMaximumFailedPasswordsForWipe(android.content.ComponentName, int)Java 文档

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