DevicePolicyManager.SetTrustAgentConfiguration Méthode

Définition

Espace de noms:: Android.App.Admin

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Définit une liste des fonctionnalités de configuration à activer pour un composant d’agent d’approbation.

[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

Paramètres

admin: ComponentName

Auquel DeviceAdminReceiver cette requête est associée. Null si l’appelant n’est pas un administrateur d’appareil

target: ComponentName

Nom du composant de l’agent à configurer.

configuration: PersistableBundle

Bundle de configuration de fonctionnalités spécifique à l’agent d’approbation. Consultez la documentation de l’agent de confiance spécifique pour déterminer l’interprétation de ce bundle.

Attributs: RegisterAttribute RequiresPermissionAttribute

Remarques

Définit une liste des fonctionnalités de configuration à activer pour un composant d’agent d’approbation. Cela est destiné à être utilisé conjointement avec #KEYGUARD_DISABLE_TRUST_AGENTS, ce qui désactive tous les agents d’approbation, mais ceux activés par cet appel de fonction. Si l’indicateur #KEYGUARD_DISABLE_TRUST_AGENTS n’est pas défini, cet appel n’a aucun effet.

Pour un agent d’approbation spécifique, qu’il soit désactivé ou non dépend de l’état agrégé du paramètre de #KEYGUARD_DISABLE_TRUST_AGENTS chaque administrateur et de sa configuration de l’agent d’approbation tel qu’il est défini par cet appel de fonction. En particulier : si un ensemble d’administrateurs #KEYGUARD_DISABLE_TRUST_AGENTS et ne définit pas de configuration d’agent d’approbation, l’agent d’approbation est désactivé complètement. Sinon, l’agent d’approbation reçoit la liste des configurations de tous les administrateurs qui définissent #KEYGUARD_DISABLE_TRUST_AGENTS et agrègent les configurations pour déterminer son comportement. La signification exacte de l’agrégation est spécifique à l’agent d’approbation.

Un administrateur d’appareil appelant doit avoir demandé DeviceAdminInfo#USES_POLICY_DISABLE_KEYGUARD_FEATURES de pouvoir appeler cette méthode ; sinon, une exception de sécurité est levée.

Cette méthode peut être appelée sur l’instance DevicePolicyManager retournée #getParentProfileInstance(ComponentName) pour définir la configuration du profil parent.

Sur les appareils ne prenant pas en charge PackageManager#FEATURE_SECURE_LOCK_SCREEN la fonctionnalité, l’appel de cette méthode n’a aucun effet : aucune configuration de l’agent d’approbation n’est définie.

Java documentation pour android.app.admin.DevicePolicyManager.setTrustAgentConfiguration(android.content.ComponentName, android.content.ComponentName, android.os.PersistableBundle).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à