DevicePolicyManager.ResetPassword(String, ResetPasswordFlags) Méthode

[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

Paramètres

Retours

Retourne true si le mot de passe a été appliqué ou false s’il n’est pas acceptable pour les contraintes actuelles.

Attributs

RegisterAttribute

Remarques

Forcez un nouveau mot de passe pour le déverrouillage de l’appareil (le mot de passe nécessaire pour accéder à l’ensemble de l’appareil) ou le défi de profil professionnel sur l’utilisateur actuel. Cela prend effet immédiatement.

Avant android.os.Build.VERSION_CODES#N, cette API est disponible pour l’administrateur de l’appareil, le propriétaire du profil et le propriétaire de l’appareil. À partir de android.os.Build.VERSION_CODES#N, l’administrateur d’appareil hérité (qui n’est pas également propriétaire du profil ou propriétaire de l’appareil) peut uniquement appeler cette API pour définir un nouveau mot de passe s’il n’existe actuellement aucun mot de passe défini. Le propriétaire du profil et le propriétaire de l’appareil peuvent continuer à forcer la modification d’un mot de passe existant tant que l’utilisateur cible est déverrouillé, bien que le propriétaire de l’appareil ne puisse pas appeler cette API du tout s’il existe également un profil managé sur l’appareil.

Entre android.os.Build.VERSION_CODES#O, android.os.Build.VERSION_CODES#P et android.os.Build.VERSION_CODES#Q, propriétaire de profil et propriétaire des appareils ciblant le niveau android.os.Build.VERSION_CODES#O sdk ou supérieur qui tente d’appeler cette API recevra SecurityException; ils sont encouragés à migrer vers la nouvelle #resetPasswordWithToken API à la place. Le propriétaire du profil et le propriétaire de l’appareil ciblant des niveaux de SDK plus anciens ne sont pas affectés : ils continuent d’expérimenter le comportement existant décrit dans le paragraphe précédent.

<em>Starting from android.os.Build.VERSION_CODES#R, cette API n’est plus prise en charge dans la plupart des cas.<Le propriétaire de l’appareil /em> et le propriétaire du profil appelant cette API recevront SecurityException s’ils ciblent le niveau android.os.Build.VERSION_CODES#O du SDK ou supérieur, ou reçoivent un échec silencieux (retour falsede l’API) s’ils ciblent un niveau inférieur du SDK. Pour les administrateurs d’appareils hérités, cette API lève SecurityException si elle cible le niveau android.os.Build.VERSION_CODES#N du SDK ou une version ultérieure et retourne false sinon. Seules les applications privilégiées contenant RESET_PASSWORD autorisation qui font partie de l’image de fabrique système peuvent toujours appeler cette API pour définir un nouveau mot de passe s’il n’existe actuellement aucun jeu de mots de passe. Dans ce cas, si l’appareil a déjà un mot de passe, cette API lève SecurityException.

Le mot de passe donné doit être suffisant pour les contraintes actuelles de qualité et de longueur du mot de passe retournées par #getPasswordQuality(ComponentName) et #getPasswordMinimumLength(ComponentName); s’il ne répond pas à ces contraintes, il sera rejeté et false retourné. Notez que le mot de passe peut être une qualité plus forte (contenant des caractères alphanumériques lorsque la qualité demandée est numérique uniquement), auquel cas la qualité actuellement active sera augmentée pour correspondre.

Sur les appareils ne prenant pas en charge PackageManager#FEATURE_SECURE_LOCK_SCREEN la fonctionnalité, cette méthode ne fait rien.

L’administrateur de l’appareil appelant doit avoir demandé DeviceAdminInfo#USES_POLICY_RESET_PASSWORD de pouvoir appeler cette méthode ; si ce n’est pas le cas, une exception de sécurité est levée.

Ce membre est déconseillé. Veuillez plutôt utiliser #resetPasswordWithToken.

Documentation Java pour android.app.admin.DevicePolicyManager.resetPassword(java.lang.String, int).

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