DevicePolicyManager.SetTrustAgentConfiguration Método
Definição
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 uma lista de recursos de configuração para habilitar um componente de agente confiável.
[Android.Runtime.Register("setTrustAgentConfiguration", "(Landroid/content/ComponentName;Landroid/content/ComponentName;Landroid/os/PersistableBundle;)V", "GetSetTrustAgentConfiguration_Landroid_content_ComponentName_Landroid_content_ComponentName_Landroid_os_PersistableBundle_Handler", ApiSince=23)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_KEYGUARD")]
public virtual void SetTrustAgentConfiguration(Android.Content.ComponentName? admin, Android.Content.ComponentName target, Android.OS.PersistableBundle? configuration);
[<Android.Runtime.Register("setTrustAgentConfiguration", "(Landroid/content/ComponentName;Landroid/content/ComponentName;Landroid/os/PersistableBundle;)V", "GetSetTrustAgentConfiguration_Landroid_content_ComponentName_Landroid_content_ComponentName_Landroid_os_PersistableBundle_Handler", ApiSince=23)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_KEYGUARD")>]
abstract member SetTrustAgentConfiguration : Android.Content.ComponentName * Android.Content.ComponentName * Android.OS.PersistableBundle -> unit
override this.SetTrustAgentConfiguration : Android.Content.ComponentName * Android.Content.ComponentName * Android.OS.PersistableBundle -> unit
Parâmetros
- admin
- ComponentName
À qual DeviceAdminReceiver essa solicitação está associada. Nulo se o chamador não for um administrador do dispositivo
- target
- ComponentName
Nome do componente do agente a ser configurado.
- configuration
- PersistableBundle
Pacote de configuração de recurso específico do agente de confiança. Consulte a documentação do agente de confiança específico para determinar a interpretação desse pacote.
- Atributos
Comentários
Define uma lista de recursos de configuração para habilitar um componente de agente confiável. Isso deve ser usado em conjunto com #KEYGUARD_DISABLE_TRUST_AGENTS, o que desabilita todos os agentes de confiança, mas aqueles habilitados por essa chamada de função. Se o sinalizador #KEYGUARD_DISABLE_TRUST_AGENTS não estiver definido, essa chamada não terá efeito.
Para qualquer agente de confiança específico, se ele está desabilitado ou não depende do estado agregado da configuração de cada administrador e de sua configuração de #KEYGUARD_DISABLE_TRUST_AGENTS agente de confiança, conforme definido por essa chamada de função. Em particular: se qualquer administrador definir #KEYGUARD_DISABLE_TRUST_AGENTS e não definir nenhuma configuração de agente confiável adicionalmente, o agente de confiança será completamente desabilitado. Caso contrário, o agente de confiança receberá a lista de configurações de todos os administradores que definem #KEYGUARD_DISABLE_TRUST_AGENTS e agregam as configurações para determinar seu comportamento. O significado exato da agregação é específico do agente de confiança.
Um administrador de dispositivo de chamada deve ter solicitado DeviceAdminInfo#USES_POLICY_DISABLE_KEYGUARD_FEATURES ser capaz de chamar esse método; caso contrário, uma exceção de segurança será gerada.
Esse método pode ser chamado na DevicePolicyManager instância retornada #getParentProfileInstance(ComponentName) para definir a configuração do perfil pai.
Em dispositivos que não dão PackageManager#FEATURE_SECURE_LOCK_SCREEN suporte ao recurso, chamar esse método não tem efeito – nenhuma configuração de agente de confiança será definida.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.