DevicePolicyManager.SetLockTaskPackages(ComponentName, String[]) 方法

定义

设置哪些包可能进入锁定任务模式。

[Android.Runtime.Register("setLockTaskPackages", "(Landroid/content/ComponentName;[Ljava/lang/String;)V", "GetSetLockTaskPackages_Landroid_content_ComponentName_arrayLjava_lang_String_Handler")]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_LOCK_TASK")]
public virtual void SetLockTaskPackages (Android.Content.ComponentName? admin, string[] packages);
[<Android.Runtime.Register("setLockTaskPackages", "(Landroid/content/ComponentName;[Ljava/lang/String;)V", "GetSetLockTaskPackages_Landroid_content_ComponentName_arrayLjava_lang_String_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_LOCK_TASK")>]
abstract member SetLockTaskPackages : Android.Content.ComponentName * string[] -> unit
override this.SetLockTaskPackages : Android.Content.ComponentName * string[] -> unit

参数

admin
ComponentName

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

packages
String[]

允许进入锁定任务模式的包列表

属性

例外

注解

设置哪些包可能进入锁定任务模式。

还允许与允许的包共享 uid 的任何包激活锁定任务。 从 android.os.Build.VERSION_CODES#M 锁定任务包列表中删除包会导致属于这些包的锁定任务完成。

此函数只能由设备所有者、关联用户或配置文件的配置文件所有者或配置文件所有者调用,或者在未设置设备所有者或拥有权限 android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASK时调用配置文件所有者。 请参阅 #isAffiliatedUser。 如果用户不关联,将清除通过此方法设置的任何包。

Build.VERSION_CODES#UPSIDE_DOWN_CAKE 开始,在设置锁定任务策略后, PolicyUpdateReceiver#onPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult) 将通知管理员策略是否已成功设置。 此回调将包含:<ul><li> 策略标识符<DevicePolicyIdentifiers#LOCK_TASK_POLICY li TargetUser> 此策略与 li PolicyUpdateResult> 相关<,也就是说PolicyUpdateResult#RESULT_POLICY_SET,如果策略已成功设置或策略未能设置的原因(例如PolicyUpdateResult#RESULT_FAILURE_CONFLICTING_ADMIN_POLICY) </ul> 如果策略已发生更改,PolicyUpdateReceiver#onPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult)将通知管理员此更改。 此回调将包含与 PolicyUpdateReceiver#onPolicySetResult 相同的参数, PolicyUpdateResult 并且将包含策略更改的原因。

Build.VERSION_CODES#UPSIDE_DOWN_CAKE头开始,锁定任务功能和锁定任务包捆绑为一个策略。 应用失败将导致应用另一个失败。

适用于 . 的 android.app.admin.DevicePolicyManager.setLockTaskPackages(android.content.ComponentName, java.lang.String[])Java 文档

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

适用于

另请参阅

  • StartLockTask()
  • <xref:Android.App.Admin.DeviceAdminReceiver.OnLockTaskModeEntering(Android.Content.Context%2c+Android.Content.Intent%2c+Android.Content.Intent)>
  • <xref:Android.App.Admin.DeviceAdminReceiver.OnLockTaskModeExiting(Android.Content.Context%2c+Android.Content.Intent)>
  • DisallowCreateWindows