DevicePolicyManager.SetLockTaskPackages(ComponentName, String[]) Método

Referência

Definição

Namespace:: Android.App.Admin

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define quais pacotes podem entrar no modo de tarefa de bloqueio.

[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

Parâmetros

admin: ComponentName

A que DeviceAdminReceiver este pedido está associado. Nulo se o chamador não for um administrador de dispositivo.

packages: String[]

A lista de pacotes com permissão para entrar no modo de tarefa de bloqueio

Atributos: RegisterAttribute RequiresPermissionAttribute

Exceções

SecurityException

Comentários

Define quais pacotes podem entrar no modo de tarefa de bloqueio.

Todos os pacotes que compartilham uid com um pacote permitido também terão permissão para ativar a tarefa de bloqueio. A remoção de pacotes da lista de android.os.Build.VERSION_CODES#M pacotes de tarefas de bloqueio resulta em tarefas bloqueadas pertencentes a esses pacotes a serem concluídas.

Essa função só pode ser chamada pelo proprietário do dispositivo, um proprietário de perfil de um usuário ou perfil afiliado ou o proprietário do perfil quando nenhum proprietário do dispositivo estiver definido ou detentores da permissão android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASK. Consulte #isAffiliatedUser. Qualquer pacote definido através deste método será limpo se o usuário se tornar não afiliado.

A partir de , após a definição da política de tarefa de Build.VERSION_CODES#UPSIDE_DOWN_CAKEbloqueio, PolicyUpdateReceiver#onPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult) notificará o administrador sobre se a política foi definida com êxito ou não. Este retorno de chamada conterá: <ul><li> O identificador<DevicePolicyIdentifiers#LOCK_TASK_POLICY de política li> O TargetUser que esta política se relaciona com <li> O PolicyUpdateResult, que será PolicyUpdateResult#RESULT_POLICY_SET se a política foi definida com êxito ou o motivo pelo qual a política não foi definida (por exemploPolicyUpdateResult#RESULT_FAILURE_CONFLICTING_ADMIN_POLICY, ) </ul> Se houve uma alteração na política, PolicyUpdateReceiver#onPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult) notificará o administrador dessa alteração. Esse retorno de chamada conterá os mesmos parâmetros que PolicyUpdateReceiver#onPolicySetResult e o PolicyUpdateResult conterá o motivo pelo qual a política foi alterada.

A partir do , os recursos de tarefas de bloqueio e os pacotes de Build.VERSION_CODES#UPSIDE_DOWN_CAKEtarefas de bloqueio são agrupados como uma política. A não aplicação de um resultará na não aplicação do outro.

Documentação Java para android.app.admin.DevicePolicyManager.setLockTaskPackages(android.content.ComponentName, java.lang.String[]).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a

Confira também

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

Compartilhar via