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> このポリシーが <li に関連するTargetUser>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以降、ロック タスク機能とロック タスク パッケージは 1 つのポリシーとしてバンドルされます。 1 つを適用しないと、もう一方の適用に失敗します。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

こちらもご覧ください

• 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