DevicePolicyManager.SetLockTaskPackages(ComponentName, String[]) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
设置哪些包可能进入锁定任务模式。
[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 开放源代码项目创建和共享的工作进行的修改,并根据 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