DevicePolicyManager.ResetPassword(String, ResetPasswordFlags) Methode

Referenz

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.

Erzwingen Sie ein neues Kennwort für die Gerätesperrung (das Kennwort, das für den Zugriff auf das gesamte Gerät erforderlich ist) oder die Arbeitsprofilabfrage für den aktuellen Benutzer.

[Android.Runtime.Register("resetPassword", "(Ljava/lang/String;I)Z", "GetResetPassword_Ljava_lang_String_IHandler")]
public virtual bool ResetPassword (string? password, Android.App.Admin.ResetPasswordFlags flags);

[<Android.Runtime.Register("resetPassword", "(Ljava/lang/String;I)Z", "GetResetPassword_Ljava_lang_String_IHandler")>]
abstract member ResetPassword : string * Android.App.Admin.ResetPasswordFlags -> bool
override this.ResetPassword : string * Android.App.Admin.ResetPasswordFlags -> bool

Parameter

password: String

Das neue Kennwort für den Benutzer. Null oder leer löscht das Kennwort.

flags: ResetPasswordFlags

Kann 0 oder Kombination von #RESET_PASSWORD_REQUIRE_ENTRY und #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT.

Gibt zurück

Boolean

Gibt "true" zurück, wenn das Kennwort angewendet wurde, oder "false", wenn es für die aktuellen Einschränkungen nicht zulässig ist.

Attribute: RegisterAttribute

Hinweise

Erzwingen Sie ein neues Kennwort für die Gerätesperrung (das Kennwort, das für den Zugriff auf das gesamte Gerät erforderlich ist) oder die Arbeitsprofilabfrage für den aktuellen Benutzer. Dies wird sofort wirksam.

Bevor android.os.Build.VERSION_CODES#Ndiese API für Geräteadministrator, Profilbesitzer und Gerätebesitzer verfügbar ist. android.os.Build.VERSION_CODES#NAb dem Legacygeräteadministrator (der nicht auch Profilbesitzer oder Gerätebesitzer ist) kann diese API nur aufrufen, um ein neues Kennwort festzulegen, wenn derzeit kein Kennwort festgelegt ist. Profilbesitzer und Gerätebesitzer können weiterhin erzwingen, dass ein vorhandenes Kennwort geändert wird, solange der Zielbenutzer entsperrt ist, obwohl der Gerätebesitzer diese API überhaupt nicht aufrufen kann, wenn auch ein verwaltetes Profil auf dem Gerät vorhanden ist.

Zwischen android.os.Build.VERSION_CODES#O, android.os.Build.VERSION_CODES#P und android.os.Build.VERSION_CODES#Q, Profilbesitzer und Gerätebesitzer für SDK-Ebene android.os.Build.VERSION_CODES#O oder höher, die versuchen, diese API aufzurufen, wird empfangen SecurityException. Stattdessen wird empfohlen, zur neuen #resetPasswordWithToken API zu migrieren. Profilbesitzer und Gerätebesitzer, die auf ältere SDK-Ebenen abzielen, sind nicht betroffen: Sie erleben weiterhin das im vorherigen Absatz beschriebene bestehende Verhalten.

<em>Starting from android.os.Build.VERSION_CODES#R, this API is no longer supported in most cases.</em> Gerätebesitzer und Profilbesitzer, der diese API aufruft, erhalten SecurityException , wenn sie die SDK-Ebene android.os.Build.VERSION_CODES#O oder höher als Ziel haben, oder sie erhalten einen automatischen Fehler (API-Rückgabe false), wenn sie auf eine niedrigere SDK-Ebene abzielen. Für Ältere Geräteadministratoren löst diese API aus SecurityException , wenn sie auf SDK-Ebene android.os.Build.VERSION_CODES#N oder höher abzielen und andernfalls zurückgegeben wird false . Nur privilegierte Apps, die RESET_PASSWORD Berechtigung enthalten, die Teil des Systemfactoryimages sind, können diese API weiterhin aufrufen, um ein neues Kennwort festzulegen, wenn derzeit kein Kennwort festgelegt ist. In diesem Fall wird diese API ausgelöst SecurityException, wenn das Gerät bereits über ein Kennwort verfügt.

Das angegebene Kennwort muss für die aktuellen Kennwortqualitäts- und Längenbeschränkungen wie zurückgegeben von #getPasswordQuality(ComponentName) und #getPasswordMinimumLength(ComponentName); wenn es diese Einschränkungen nicht erfüllt, wird es abgelehnt und falsch zurückgegeben. Beachten Sie, dass das Kennwort möglicherweise eine stärkere Qualität (die alphanumerische Zeichen enthält, wenn die angeforderte Qualität nur numerisch ist), in diesem Fall wird die derzeit aktive Qualität erhöht, um übereinstimmungen zu können.

Auf Geräten, die keine Funktion unterstützen PackageManager#FEATURE_SECURE_LOCK_SCREEN , führt diese Methode nichts aus.

Der aufrufende Geräteadministrator muss die DeviceAdminInfo#USES_POLICY_RESET_PASSWORD Möglichkeit haben, diese Methode aufzurufen. Wenn dies nicht der Fall ist, wird eine Sicherheits ausnahme ausgelöst.

Dieses Mitglied ist veraltet. Verwenden Sie stattdessen #resetPasswordWithToken.

Java-Dokumentation für android.app.admin.DevicePolicyManager.resetPassword(java.lang.String, 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:

Freigeben über