DevicePolicyManager.SetTrustAgentConfiguration Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Establece una lista de características de configuración que se habilitarán para un componente de agente de confianza.
[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
Al que DeviceAdminReceiver está asociada esta solicitud. Null si el autor de la llamada no es un administrador de dispositivos
- target
- ComponentName
Nombre de componente del agente que se va a configurar.
- configuration
- PersistableBundle
Agrupación de configuración de características específica del agente de confianza. Consulte la documentación del agente de confianza específico para determinar la interpretación de este paquete.
- Atributos
Comentarios
Establece una lista de características de configuración que se habilitarán para un componente de agente de confianza. Esto está pensado para usarse junto con #KEYGUARD_DISABLE_TRUST_AGENTS, que deshabilita todos los agentes de confianza, pero los habilitados por esta llamada de función. Si no se establece la marca #KEYGUARD_DISABLE_TRUST_AGENTS , esta llamada no tiene ningún efecto.
Para cualquier agente de confianza específico, tanto si está deshabilitado como si no depende del estado agregado de la configuración de cada administrador y de su configuración del #KEYGUARD_DISABLE_TRUST_AGENTS agente de confianza según lo establezca esta llamada de función. En concreto: si algún conjunto de administradores #KEYGUARD_DISABLE_TRUST_AGENTS y no establece además ninguna configuración del agente de confianza, el agente de confianza está deshabilitado completamente. De lo contrario, el agente de confianza recibirá la lista de configuraciones de todos los administradores que establecen #KEYGUARD_DISABLE_TRUST_AGENTS y agregan las configuraciones para determinar su comportamiento. El significado exacto de la agregación es específico del agente de confianza.
Un administrador de dispositivos que llama debe haber solicitado DeviceAdminInfo#USES_POLICY_DISABLE_KEYGUARD_FEATURES poder llamar a este método; si no es así, se producirá una excepción de seguridad.
Se puede llamar a este método en la DevicePolicyManager instancia devuelta por #getParentProfileInstance(ComponentName) para establecer la configuración del perfil primario.
En los dispositivos que no admiten PackageManager#FEATURE_SECURE_LOCK_SCREEN características, llamar a este método no tiene ningún efecto: no se establecerá ninguna configuración del agente de confianza.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.