DevicePolicyManager.SetTrustAgentConfiguration Methode

Definition

Namespace:: Android.App.Admin

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Legt eine Liste der Konfigurationsfeatures fest, die für eine Vertrauensstellungs-Agent-Komponente aktiviert werden sollen.

[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

Parameter

admin: ComponentName

Dieser DeviceAdminReceiver Anforderung ist zugeordnet. Null, wenn der Anrufer kein Geräteadministrator ist

target: ComponentName

Komponentenname des zu konfigurierenden Agents.

configuration: PersistableBundle

Sicherheits-Agent-spezifisches Featurekonfigurationspaket. Bitte konsultieren Sie die Dokumentation des spezifischen Vertrauensagenten, um die Auslegung dieses Bundles zu ermitteln.

Attribute: RegisterAttribute RequiresPermissionAttribute

Hinweise

Legt eine Liste der Konfigurationsfeatures fest, die für eine Vertrauensstellungs-Agent-Komponente aktiviert werden sollen. Dies ist in Verbindung mit #KEYGUARD_DISABLE_TRUST_AGENTS, die alle Vertrauens-Agents deaktiviert, die jedoch durch diesen Funktionsaufruf aktiviert werden. Wenn die Kennzeichnung #KEYGUARD_DISABLE_TRUST_AGENTS nicht festgelegt ist, hat dieser Aufruf keine Auswirkung.

Für einen bestimmten Vertrauens-Agent, unabhängig davon, ob er deaktiviert ist oder nicht, hängt vom aggregierten Status der Einstellung jedes Administrators #KEYGUARD_DISABLE_TRUST_AGENTS und seiner Vertrauens-Agent-Konfiguration ab, wie durch diesen Funktionsaufruf festgelegt. Insbesondere: Wenn ein Administrator eine Vertrauens-Agent-Konfiguration festlegt #KEYGUARD_DISABLE_TRUST_AGENTS und nicht zusätzlich festlegt, ist der Vertrauens-Agent vollständig deaktiviert. Andernfalls erhält der Vertrauens-Agent die Liste der Konfigurationen von allen Administratoren, die die Konfigurationen festlegen #KEYGUARD_DISABLE_TRUST_AGENTS und aggregieren, um sein Verhalten zu bestimmen. Die genaue Bedeutung der Aggregation ist vertrauens-agentspezifisch.

Ein Aufrufen eines Geräteadministrators muss die DeviceAdminInfo#USES_POLICY_DISABLE_KEYGUARD_FEATURES Möglichkeit haben, diese Methode aufzurufen. Wenn dies nicht der Fall ist, wird eine Sicherheits ausnahme ausgelöst.

Diese Methode kann für die DevicePolicyManager instanz aufgerufen werden, die #getParentProfileInstance(ComponentName) zurückgegeben wird, um die Konfiguration für das übergeordnete Profil festzulegen.

Auf Geräten, die das Feature nicht unterstützen PackageManager#FEATURE_SECURE_LOCK_SCREEN , hat das Aufrufen dieser Methode keine Auswirkung . Es wird keine Konfiguration des Vertrauens-Agents festgelegt.

Java Dokumentation für android.app.admin.DevicePolicyManager.setTrustAgentConfiguration(android.content.ComponentName, android.content.ComponentName, android.os.PersistableBundle).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: