DevicePolicyManager.AddPersistentPreferredActivity メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
プロファイル所有者、デバイス所有者、またはアクセス許可 android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASK
の所有者によって呼び出されます。
[Android.Runtime.Register("addPersistentPreferredActivity", "(Landroid/content/ComponentName;Landroid/content/IntentFilter;Landroid/content/ComponentName;)V", "GetAddPersistentPreferredActivity_Landroid_content_ComponentName_Landroid_content_IntentFilter_Landroid_content_ComponentName_Handler")]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_LOCK_TASK")]
public virtual void AddPersistentPreferredActivity (Android.Content.ComponentName? admin, Android.Content.IntentFilter? filter, Android.Content.ComponentName activity);
[<Android.Runtime.Register("addPersistentPreferredActivity", "(Landroid/content/ComponentName;Landroid/content/IntentFilter;Landroid/content/ComponentName;)V", "GetAddPersistentPreferredActivity_Landroid_content_ComponentName_Landroid_content_IntentFilter_Landroid_content_ComponentName_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_LOCK_TASK")>]
abstract member AddPersistentPreferredActivity : Android.Content.ComponentName * Android.Content.IntentFilter * Android.Content.ComponentName -> unit
override this.AddPersistentPreferredActivity : Android.Content.ComponentName * Android.Content.IntentFilter * Android.Content.ComponentName -> unit
パラメーター
- admin
- ComponentName
DeviceAdminReceiver
この要求が関連付けられているもの。 呼び出し元がデバイス管理者でない場合は Null。
- filter
- IntentFilter
既定のハンドラーが追加される IntentFilter。
- activity
- ComponentName
既定の意図ハンドラーとして追加されるアクティビティ。
- 属性
注釈
プロファイル所有者、デバイス所有者、またはアクセス許可 android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASK
の所有者によって呼び出されます。 指定 IntentFilter
した に一致する意図を処理するためにシステムが選択する既定のアクティビティを設定する場合。 このアクティビティは、意図フィルターの潜在的なイベント ハンドラーのセットが変更され、意図の基本設定がリセットされた場合でも、既定の意図ハンドラーのままです。
呼び出し元はマニフェストでアクティビティを宣言する必要があることに注意してください。API は、指定された意図フィルターを処理する既定のアクティビティにアクティビティを設定するだけです。
アクティビティがインストールされていない場合(もう)、既定のあいまいさの解消メカニズムが引き継ぎます。 アクティビティが (再インストール) されると、フィルターの既定の意図ハンドラーとして自動的にリセットされます。
呼び出し元のデバイス管理者は、プロファイル所有者またはデバイス所有者である必要があります。 そうでない場合は、セキュリティ例外がスローされます。
Build.VERSION_CODES#UPSIDE_DOWN_CAKE
から、永続的な優先アクティビティ ポリシーが設定された後、PolicyUpdateReceiver#onPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult)
ポリシーが正常に設定されたかどうかについて管理者に通知されます。 このコールバックには次が含まれます: ul>li ポリシー識別子<DevicePolicyIdentifiers#PERSISTENT_PREFERRED_ACTIVITY_POLICY
li> ポリシーが適用<される意図フィルターを含むPolicyUpdateReceiver#EXTRA_INTENT_FILTER
追加のポリシー パラメーター バンドル。TargetUser
このポリシーは li>PolicyUpdateResult#RESULT_POLICY_SET
>PolicyUpdateResult
に<関連します。これは、ポリシーが正常に設定されたか、ポリシーが設定されなかった理由 (例: PolicyUpdateResult#RESULT_FAILURE_CONFLICTING_ADMIN_POLICY
) </ul> ポリシーに変更があった場合です。><<PolicyUpdateReceiver#onPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult)
は、この変更を管理者に通知します。 このコールバックには PolicyUpdateReceiver#onPolicySetResult と同じパラメーターが含まれており PolicyUpdateResult
、 にはポリシーが変更された理由が含まれます。
注: ディスク I/O を実行し、メイン スレッドで呼び出すことはできません。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。