DevicePolicyManager.AddPersistentPreferredActivity Metodo

Definizione

Spazio dei nomi:: Android.App.Admin

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Chiamato da un proprietario del profilo o dal proprietario del dispositivo o dal titolare dell'autorizzazione 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

Parametri

admin: ComponentName

A cui DeviceAdminReceiver è associata questa richiesta. Null se il chiamante non è un amministratore del dispositivo.

filter: IntentFilter

IntentFilter per il quale viene aggiunto un gestore predefinito.

activity: ComponentName

Attività aggiunta come gestore finalità predefinito.

Attributi: RegisterAttribute RequiresPermissionAttribute

Commenti

Chiamato da un proprietario del profilo o dal proprietario del dispositivo o dal titolare dell'autorizzazione android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASK. per impostare un'attività predefinita selezionata dal sistema per gestire le finalità corrispondenti all'oggetto specificato IntentFilter anziché visualizzare il meccanismo di ambiguità predefinito. Questa attività rimarrà il gestore finalità predefinito anche se il set di potenziali gestori eventi per il filtro finalità cambia e se le preferenze di finalità vengono reimpostate.

Si noti che l'applicazione di destinazione deve comunque dichiarare l'attività nel manifesto, l'API imposta semplicemente l'attività come predefinita per gestire il filtro di finalità specificato.

Il meccanismo di disambiguazione predefinito assume il controllo se l'attività non è più installata (più). Quando l'attività è (nuovamente)installata, viene reimpostata automaticamente come gestore finalità predefinito per il filtro.

Si noti che la chiamata a questa API per impostare un gestore finalità predefinito, consente solo di evitare il meccanismo di ambiguità predefinito. Le finalità implicite che non attivano questo meccanismo (ad esempio richiamando il browser) non possono essere configurate perché sono controllate da altre configurazioni.

L'amministratore del dispositivo chiamante deve essere un proprietario del profilo o un proprietario del dispositivo. In caso contrario, verrà generata un'eccezione di sicurezza.

A partire da Build.VERSION_CODES#UPSIDE_DOWN_CAKE, dopo che è stato impostato il criterio di attività preferito permanente, PolicyUpdateReceiver#onPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult) indicherà all'amministratore se il criterio è stato impostato correttamente o meno. Questo callback conterrà: <ul><li> L'identificatore<DevicePolicyIdentifiers#PERSISTENT_PREFERRED_ACTIVITY_POLICY dei criteri li> Il bundle di parametri di criteri aggiuntivi, che contiene PolicyUpdateReceiver#EXTRA_INTENT_FILTER il filtro finalità applicato al criterio si applica a <li> Il TargetUser che questo criterio è correlato a <li> The PolicyUpdateResult, che sarà PolicyUpdateResult#RESULT_POLICY_SET se il criterio è stato impostato correttamente o il motivo per cui il criterio non è stato impostato (ad esempio PolicyUpdateResult#RESULT_FAILURE_CONFLICTING_ADMIN_POLICY) </ul> Se è stata apportata una modifica al criterio, PolicyUpdateReceiver#onPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult) informerà l'amministratore di questa modifica. Questo callback conterrà gli stessi parametri di PolicyUpdateReceiver#onPolicySetResult e PolicyUpdateResult conterrà il motivo per cui il criterio è stato modificato.

NOTA: esegue l'I/O del disco e non deve essere chiamato sul thread principale.

per android.app.admin.DevicePolicyManager.addPersistentPreferredActivity(android.content.ComponentName, android.content.IntentFilter, android.content.ComponentName).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a