共用方式為


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 此原則與 li PolicyUpdateResultTargetUser>> 相關<。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