Freigeben über


DevicePolicyManager.SetMaximumFailedPasswordsForWipe Methode

Definition

Wenn Sie diesen Wert auf einen Wert festlegen, der größer als 0 ist, wird eine Richtlinie aktiviert, die ein Gerät oder eine Profilzurücksetzung durchführt, nachdem zu viele falsche Kennwörter für die Gerätesperrung eingegeben wurden.

[Android.Runtime.Register("setMaximumFailedPasswordsForWipe", "(Landroid/content/ComponentName;I)V", "GetSetMaximumFailedPasswordsForWipe_Landroid_content_ComponentName_IHandler")]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_WIPE_DATA")]
public virtual void SetMaximumFailedPasswordsForWipe (Android.Content.ComponentName? admin, int num);
[<Android.Runtime.Register("setMaximumFailedPasswordsForWipe", "(Landroid/content/ComponentName;I)V", "GetSetMaximumFailedPasswordsForWipe_Landroid_content_ComponentName_IHandler")>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_WIPE_DATA")>]
abstract member SetMaximumFailedPasswordsForWipe : Android.Content.ComponentName * int -> unit
override this.SetMaximumFailedPasswordsForWipe : Android.Content.ComponentName * int -> unit

Parameter

admin
ComponentName

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

num
Int32

Die Anzahl der fehlgeschlagenen Kennwortversuche, an der das Gerät oder Profil zurückgesetzt wird.

Attribute

Hinweise

Wenn Sie diesen Wert auf einen Wert festlegen, der größer als 0 ist, wird eine Richtlinie aktiviert, die ein Gerät oder eine Profilzurücksetzung durchführt, nachdem zu viele falsche Kennwörter für die Gerätesperrung eingegeben wurden. Diese Richtlinie kombiniert die Überwachung auf fehlgeschlagene Kennwörter und das Löschen des Geräts und erfordert, dass der Aufruf von Geräteadministratoren sowohl als DeviceAdminInfo#USES_POLICY_WIPE_DATAauch DeviceAdminInfo#USES_POLICY_WATCH_LOGIN }angefordert wird.

Wenn diese Richtlinie auf dem System oder dem Hauptbenutzer festgelegt ist, wird das Gerät nach zu vielen falschen Kennwortversuchen zurückgesetzt. Wenn sie für einen anderen Benutzer festgelegt ist, wird nur der entsprechende Benutzer oder das entsprechende Profil zurückgesetzt.

Wenn Sie eine andere Richtlinie implementieren möchten (z. B. daten nur für eine bestimmte Anwendung, das Löschen oder Widerrufen von Anmeldeinformationen oder das Melden des Fehlers an einen Server), sollten Sie stattdessen implementieren DeviceAdminReceiver#onPasswordFailed(Context, android.content.Intent) . Verwenden Sie diese API nicht, da, wenn die maximale Anzahl erreicht ist, das Gerät oder Profil sofort zurückgesetzt wird und Ihr Rückruf nicht aufgerufen wird.

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

Auf Geräten, die das Feature nicht unterstützen PackageManager#FEATURE_SECURE_LOCK_SCREEN , ist das Kennwort immer leer und diese Methode hat keine Auswirkung , d. h. die Richtlinie ist nicht festgelegt.

Java-Dokumentation für android.app.admin.DevicePolicyManager.setMaximumFailedPasswordsForWipe(android.content.ComponentName, int).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: