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

定義

命名空間:

Android.App.Admin

組件:

Mono.Android.dll

設定可進入鎖定任務模式的套件。

[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[]

允許進入鎖定任務模式的套件清單

屬性

RegisterAttribute RequiresPermissionAttribute

例外狀況

SecurityException

備註

設定可進入鎖定任務模式的套件。

任何與允許套件共用 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相關 The ，即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開始，鎖定任務功能與鎖定任務套件會整合成一個政策。 未套用其中一種，將導致無法套用另一套。

Java 文件 android.app.admin.DevicePolicyManager.setLockTaskPackages(android.content.ComponentName, java.lang.String[])。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

另請參閱

• 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