DevicePolicyManager.SetPasswordQuality(ComponentName, PasswordQuality) 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.

Wird von einer Anwendung aufgerufen, die das Gerät verwaltet, um die kennworteinschränkenden Einschränkungen festzulegen.

[Android.Runtime.Register("setPasswordQuality", "(Landroid/content/ComponentName;I)V", "GetSetPasswordQuality_Landroid_content_ComponentName_IHandler")]
public virtual void SetPasswordQuality(Android.Content.ComponentName admin, Android.App.Admin.PasswordQuality quality);

[<Android.Runtime.Register("setPasswordQuality", "(Landroid/content/ComponentName;I)V", "GetSetPasswordQuality_Landroid_content_ComponentName_IHandler")>]
abstract member SetPasswordQuality : Android.Content.ComponentName * Android.App.Admin.PasswordQuality -> unit
override this.SetPasswordQuality : Android.Content.ComponentName * Android.App.Admin.PasswordQuality -> unit

Parameter

admin: ComponentName

Dieser DeviceAdminReceiver Anforderung ist zugeordnet.

quality: PasswordQuality

Die neue gewünschte Qualität. Einer von #PASSWORD_QUALITY_UNSPECIFIED, #PASSWORD_QUALITY_BIOMETRIC_WEAK, #PASSWORD_QUALITY_SOMETHING, #PASSWORD_QUALITY_NUMERIC, , #PASSWORD_QUALITY_NUMERIC_COMPLEX, , , oder #PASSWORD_QUALITY_ALPHABETIC#PASSWORD_QUALITY_ALPHANUMERIC#PASSWORD_QUALITY_COMPLEX.

Attribute: RegisterAttribute

Hinweise

Wird von einer Anwendung aufgerufen, die das Gerät verwaltet, um die kennworteinschränkenden Einschränkungen festzulegen. Nach dem Festlegen kann der Benutzer kein neues Kennwort eingeben, das nicht mindestens so restriktiv ist wie das festgelegte. Beachten Sie, dass das aktuelle Kennwort verbleibt, bis der Benutzer ein neues Kennwort festgelegt hat, sodass die Änderung nicht sofort erfolgt. Wenn Sie den Benutzer zur Eingabe eines neuen Kennworts auffordern möchten, verwenden #ACTION_SET_NEW_PASSWORD Oder #ACTION_SET_NEW_PARENT_PROFILE_PASSWORD nachdem Sie diese Methode aufgerufen haben.

Qualitätskonstanten werden so angeordnet, dass höhere Werte restriktiver sind; daher ist die höchste angeforderte Qualitätskonstante (zwischen der hier festgelegten Richtlinie, der Einstellung des Benutzers und allen anderen Überlegungen) das, was in Kraft ist.

Auf Geräten, die das Feature nicht unterstützen PackageManager#FEATURE_SECURE_LOCK_SCREEN , wird das Kennwort immer als leer behandelt.

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

Apps für die Zielbestimmung android.os.Build.VERSION_CODES#R und unten können diese Methode für die von der DevicePolicyManager Instanz zurückgegebene #getParentProfileInstance(ComponentName) Instanz aufrufen, um Einschränkungen für das übergeordnete Profil festzulegen. Apps, die auf einem unternehmenseigenen Gerät (wie identifiziert #isOrganizationOwnedDeviceWithManagedProfilewerden können) und android.os.Build.VERSION_CODES#S höher, mit Ausnahme eines Profilbesitzers, erhalten beim Aufrufen dieser Methode in der übergeordneten DevicePolicyManager Instanz eine IllegalArgumentException App.

<strong>Note:</strong> Specifying password requirements using this method clears the password complexity requirements set using #setRequiredPasswordComplexity(int). Wenn diese Methode für die DevicePolicyManager von der Instanz zurückgegebene #getParentProfileInstance(ComponentName)Instanz aufgerufen wird, müssen die anforderungen an die Kennwortkomplexität, die für die primäre Instanz DevicePolicyManager festgelegt wurden, zuerst durch Aufrufen #setRequiredPasswordComplexity von #PASSWORD_COMPLEXITY_NONE) gelöscht werden.

<p-Zeichenfolge><>Hinweis:</strong> diese Methode wird für {PackageManager#FEATURE_AUTOMOTIVE Automotive-Builds ignoriert.

Dieses Element ist veraltet. #setRequiredPasswordComplexity(int)Verwenden Sie lieber ein Kennwort, das eine komplexitätsstufe erfüllt, die von der Plattform definiert wird, anstatt eine benutzerdefinierte Kennwortanforderung anzugeben. Das Festlegen von benutzerdefinierten, übermäßig komplizierten Kennwortanforderungen führt zu Kennwörtern, die benutzern schwer zu merken sind und möglicherweise keine Sicherheitsvorteile bieten, da Android hardwaregestützte Drosselungen verwendet, um Online- und Offline-Brute-Force der Bildschirmsperre des Geräts zu verhindern. Unternehmenseigene Geräte (vollständig verwaltete und organisationseigene verwaltete Profilgeräte) können diese Methode weiterhin verwenden, es wird jedoch empfohlen, #setRequiredPasswordComplexity(int) stattdessen zu verwenden.

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

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: