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