DevicePolicyManager.AddPersistentPreferredActivity Methode

Definition

Namespace:: Android.App.Admin

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Wird von einem Profilbesitzer oder Gerätebesitzer oder Besitzer 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

Dieser DeviceAdminReceiver Anforderung ist zugeordnet. Null, wenn der Anrufer kein Geräteadministrator ist.

filter: IntentFilter

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

activity: ComponentName

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

Attribute: RegisterAttribute RequiresPermissionAttribute

Hinweise

Wird von einem Profilbesitzer oder Gerätebesitzer oder Besitzer 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 IntentFilter Entsprechen entsprechen, anstatt den Standardmäßigen Mehrdeutigkeitsmechanismus anzuzeigen. Diese Aktivität bleibt der Standardabsichthandler, auch wenn sich der Satz potenzieller Ereignishandler für den Intent-Filter ändert und wenn die Absichtseinstellungen zurückgesetzt werden.

Beachten Sie, dass die Zielanwendung die Aktivität im Manifest weiterhin deklarieren sollte. Die API legt lediglich die Aktivität als Standard fest, um den angegebenen Intent-Filter zu verarbeiten.

Der Standardmäßige Mehrdeutigkeitsmechanismus übernimmt die Übernahme, wenn die Aktivität nicht mehr installiert ist (mehr). Wenn die Aktivität (neu) installiert wird, wird sie automatisch als Standardabsichthandler für den Filter zurückgesetzt.

Beachten Sie, dass das Aufrufen dieser API zum Festlegen eines Standardabsichthandlers nur die Vermeidung des Standardmäßigen Mehrdeutigkeitsmechanismus zulässt. Implizite Absichten, die diesen Mechanismus nicht auslösen (z. B. das Aufrufen des Browsers), können nicht konfiguriert werden, da sie von anderen Konfigurationen gesteuert werden.

Der aufrufende Geräteadministrator muss ein Profilbesitzer oder Gerätebesitzer sein. Wenn dies nicht der Fehler ist, wird eine Sicherheits ausnahme ausgelöst.

Build.VERSION_CODES#UPSIDE_DOWN_CAKEAb , nachdem die richtlinie für dauerhafte bevorzugte Aktivität festgelegt wurde, benachrichtigt der Administrator darüber, PolicyUpdateReceiver#onPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult) ob die Richtlinie erfolgreich festgelegt wurde oder nicht. Dieser Rückruf enthält: ul>li Der Richtlinienbezeichner<DevicePolicyIdentifiers#PERSISTENT_PREFERRED_ACTIVITY_POLICY li> Das zusätzliche Richtlinien-Params-Bundle, das den Absichtsfilter enthältPolicyUpdateReceiver#EXTRA_INTENT_FILTER, der sich auf <li> bezieht. Die TargetUser Richtlinie bezieht sich auf <li> The PolicyUpdateResult, was dann der Fall sein PolicyUpdateResult#RESULT_POLICY_SET wird, 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 aufgetreten ist,><<PolicyUpdateReceiver#onPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult) benachrichtigt den Administrator über diese Änderung. Dieser Rückruf enthält dieselben Parameter wie PolicyUpdateReceiver#onPolicySetResult und enthält den PolicyUpdateResult Grund, warum die Richtlinie geändert wurde.

HINWEIS: Führt Datenträger-E/A aus und sollte nicht im Hauptthread 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 auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: