语言

DevicePolicyManager.LockNow 方法

定义

重载

名称 说明
LockNow()

立即锁定设备,就像锁屏超时在此调用时已过期一样。

LockNow(DevicePolicyManagerFlags)

立即锁定设备,就像锁屏超时在此调用时已过期一样。

LockNow()

立即锁定设备,就像锁屏超时在此调用时已过期一样。

[Android.Runtime.Register("lockNow", "()V", "GetLockNowHandler")]
[Android.Runtime.RequiresPermission("android.permission.LOCK_DEVICE")]
public virtual void LockNow();
[<Android.Runtime.Register("lockNow", "()V", "GetLockNowHandler")>]
[<Android.Runtime.RequiresPermission("android.permission.LOCK_DEVICE")>]
abstract member LockNow : unit -> unit
override this.LockNow : unit -> unit
特性

注解

立即锁定设备,就像锁屏超时在此调用时已过期一样。

此方法保护设备以响应紧急情况,例如丢失或被盗的设备。 调用此方法后,必须使用强身份验证(PIN、模式或密码)解锁设备。 此 API 仅供设备管理员使用。

从版本 android.os.Build.VERSION_CODES#R 开始,调用方必须具有LOCK_DEVICE权限,或者设备必须具有设备管理员功能;如果两者都不是 true,则该方法将返回而不完成任何操作。 在版本 android.os.Build.VERSION_CODES#R之前,无论调用方的权限如何,设备都需要设备管理员功能。

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

如果没有设置锁类型,此方法会强制设备进入睡眠状态,但不会锁定设备。 查找处于此状态的设备的设备管理员可以先调用 #resetPassword 设置密码,然后锁定设备,从而锁定其他不安全的设备。

可以在返回#getParentProfileInstance(ComponentName)的DevicePolicyManager实例上调用此方法,以锁定父配置文件。

注意:打开 android.content.pm.PackageManager#FEATURE_AUTOMOTIVE automotive builds时,此方法不会关闭屏幕,因为这将是驾驶安全干扰。

等效于不带标志的调用 #lockNow(int) 。

Java文档android.app.admin.DevicePolicyManager.lockNow()。

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

适用于

LockNow(DevicePolicyManagerFlags)

立即锁定设备,就像锁屏超时在此调用时已过期一样。

[Android.Runtime.Register("lockNow", "(I)V", "GetLockNow_IHandler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.LOCK_DEVICE")]
public virtual void LockNow(Android.App.Admin.DevicePolicyManagerFlags flags);
[<Android.Runtime.Register("lockNow", "(I)V", "GetLockNow_IHandler", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.LOCK_DEVICE")>]
abstract member LockNow : Android.App.Admin.DevicePolicyManagerFlags -> unit
override this.LockNow : Android.App.Admin.DevicePolicyManagerFlags -> unit

参数

flags
DevicePolicyManagerFlags

可以是 0 或 #FLAG_EVICT_CREDENTIAL_ENCRYPTION_KEY。

特性

注解

立即锁定设备,就像锁屏超时在此调用时已过期一样。

此方法保护设备以响应紧急情况,例如丢失或被盗的设备。 调用此方法后,必须使用强身份验证(PIN、模式或密码)解锁设备。 此 API 仅供设备管理员使用。

从版本 android.os.Build.VERSION_CODES#R 开始,调用方必须具有LOCK_DEVICE权限,或者设备必须具有设备管理员功能;如果两者都不是 true,则该方法将返回而不完成任何操作。 在版本 android.os.Build.VERSION_CODES#R之前,无论调用方的权限如何,设备都需要设备管理员功能。

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

如果没有设置锁类型,此方法会强制设备进入睡眠状态,但不会锁定设备。 查找处于此状态的设备的设备管理员可以先调用 #resetPassword 设置密码,然后锁定设备,从而锁定其他不安全的设备。

可以在返回#getParentProfileInstance(ComponentName)的DevicePolicyManager实例上调用此方法,以便锁定父配置文件和托管配置文件。

注意:若要锁定父配置文件并逐出托管配置文件的加密密钥,#lockNow()必须调用两次:首先,#lockNow()应在返回#getParentProfileInstance(ComponentName)的实例上DevicePolicyManager调用,然后#lockNow(int)应在与托管配置文件关联的实例上DevicePolicyManager调用该#FLAG_EVICT_CREDENTIAL_ENCRYPTION_KEY标志。 按此顺序调用该方法两次可确保所有用户都处于锁定状态,并且不会阻止托管配置文件上的设备管理员发出第二次调用来锁定其自己的配置文件。

注意:打开 android.content.pm.PackageManager#FEATURE_AUTOMOTIVE automotive builds时,此方法不会关闭屏幕,因为这将是驾驶安全干扰。

Java文档android.app.admin.DevicePolicyManager.lockNow(int)。

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

适用于