DevicePolicyManager.AddPersistentPreferredActivity Methode

Definition

Namespace:

Android.App.Admin

Assembly:

Mono.Android.dll

Wird von einem Profilbesitzer, Gerätebesitzer oder Inhaber der Berechtigung android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASKaufgerufen.

[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

Parameter

admin

ComponentName

Dem DeviceAdminReceiver diese Anforderung zugeordnet ist. Null, wenn der Aufrufer kein Geräteadministrator ist.

filter

IntentFilter

Der IntentFilter, für den ein Standardhandler hinzugefügt wird.

activity

ComponentName

Die Aktivität, die als Standardabsichtshandler hinzugefügt wird.

Attribute

RegisterAttribute RequiresPermissionAttribute

Hinweise

Wird von einem Profilbesitzer, Gerätebesitzer oder Inhaber der Berechtigung android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASKaufgerufen. , um eine Standardaktivität festzulegen, die vom System ausgewählt wird, um Absichten zu behandeln, die dem angegebenen IntentFilterentsprechen. Diese Aktivität bleibt der Standardabsichtshandler, auch wenn sich der Satz potenzieller Ereignishandler für den Absichtsfilter ändert und die Absichtseinstellungen zurückgesetzt werden.

Beachten Sie, dass der Aufrufer die Aktivität im Manifest weiterhin deklarieren soll. Die API legt die Aktivität lediglich als Standardaktivität fest, um den angegebenen Absichtsfilter zu behandeln.

Wenn die Aktivität nicht (mehr) installiert ist, übernimmt der Standardmechanismus zur Mehrdeutigkeit. Wenn die Aktivität (neu) installiert wird, wird sie automatisch als Standardabsichtshandler für den Filter zurückgesetzt.

Der aufrufende Geräteadministrator muss ein Profilbesitzer oder Gerätebesitzer sein. Andernfalls wird eine Sicherheits exception ausgelöst.

Build.VERSION_CODES#UPSIDE_DOWN_CAKEAb wird der Administrator benachrichtigt, ob die Richtlinie erfolgreich festgelegt wurde, PolicyUpdateReceiver#onPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult) nachdem die Richtlinie für persistente bevorzugte Aktivitäten festgelegt wurde. Dieser Rückruf enthält Folgendes: <ul<>li> The policy identifier<DevicePolicyIdentifiers#PERSISTENT_PREFERRED_ACTIVITY_POLICY li> The additional policy params bundle, that contains PolicyUpdateReceiver#EXTRA_INTENT_FILTER the intent filter the policy applies to <li> The TargetUser that this policy bezieht sich auf <li> The PolicyUpdateResult, die lautetPolicyUpdateResult#RESULT_POLICY_SET, wenn die Richtlinie erfolgreich festgelegt wurde oder der Grund, warum die Richtlinie nicht festgelegt werden konnte (z. B. PolicyUpdateResult#RESULT_FAILURE_CONFLICTING_ADMIN_POLICY) </ul> Wenn eine Änderung an der Richtlinie erfolgt, PolicyUpdateReceiver#onPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult) benachrichtigt den Administrator über diese Änderung. Dieser Rückruf enthält die gleichen Parameter wie PolicyUpdateReceiver#onPolicySetResult und enthält PolicyUpdateResult den Grund, warum die Richtlinie geändert wurde.

HINWEIS: Führt Datenträger-E/A aus und sollte nicht im Standard-Thread aufgerufen werden.

Java-Dokumentation für android.app.admin.DevicePolicyManager.addPersistentPreferredActivity(android.content.ComponentName, android.content.IntentFilter, android.content.ComponentName).

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.