DevicePolicyManager.ResetPassword(String, ResetPasswordFlags) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Forzar una nueva contraseña para el desbloqueo del dispositivo (la contraseña necesaria para acceder a todo el dispositivo) o el desafío del perfil de trabajo en el usuario actual.
[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 -> boolParámetros
- password
- String
Nueva contraseña para el usuario. Null o vacío borra la contraseña.
- flags
- ResetPasswordFlags
Puede ser 0 o combinación de #RESET_PASSWORD_REQUIRE_ENTRY y #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT.
Devoluciones
Devuelve true si se aplicó la contraseña o false si no es aceptable para las restricciones actuales.
- Atributos
Comentarios
Forzar una nueva contraseña para el desbloqueo del dispositivo (la contraseña necesaria para acceder a todo el dispositivo) o el desafío del perfil de trabajo en el usuario actual. Esto surte efecto inmediatamente.
Antes de android.os.Build.VERSION_CODES#N, esta API está disponible para el administrador de dispositivos, el propietario del perfil y el propietario del dispositivo. A partir de , el administrador de android.os.Build.VERSION_CODES#Ndispositivos heredado (que no es también propietario del perfil o propietario del dispositivo) solo puede llamar a esta API para establecer una nueva contraseña si actualmente no hay ningún conjunto de contraseñas. El propietario del perfil y el propietario del dispositivo pueden seguir obligando a cambiar una contraseña existente siempre que se desbloquee el usuario de destino, aunque el propietario del dispositivo no podrá llamar a esta API en absoluto si también hay un perfil administrado en el dispositivo.
Entre android.os.Build.VERSION_CODES#O, android.os.Build.VERSION_CODES#P y , el propietario del android.os.Build.VERSION_CODES#Qperfil y el propietario de dispositivos que tienen como destino el nivel android.os.Build.VERSION_CODES#O del SDK o superior que intentan llamar a esta API recibirán SecurityException; se recomienda migrar a la nueva #resetPasswordWithToken API en su lugar. El propietario del perfil y el propietario del dispositivo que tienen como destino niveles de SDK anteriores no se ven afectados: siguen experimentando el comportamiento existente descrito en el párrafo anterior.
<em>A partir de android.os.Build.VERSION_CODES#R, esta API ya no se admite en la mayoría de los casos.</em> Propietario del dispositivo y propietario del perfil que llama a esta API recibirán SecurityException si tienen como destino el nivel android.os.Build.VERSION_CODES#O de SDK o superior, o recibirán un error silencioso (API que devuelve false) si tienen como destino el nivel de SDK inferior. En el caso de los administradores de dispositivos heredados, esta API produce SecurityException si tienen como destino el nivel android.os.Build.VERSION_CODES#N de SDK o superior y devuelve false lo contrario. Solo las aplicaciones con privilegios que contienen RESET_PASSWORD permiso que forman parte de la imagen de fábrica del sistema todavía pueden llamar a esta API para establecer una nueva contraseña si actualmente no hay ningún conjunto de contraseñas. En este caso, si el dispositivo ya tiene una contraseña, esta API iniciará SecurityException.
La contraseña especificada debe ser suficiente para las restricciones actuales de calidad y longitud de la contraseña tal #getPasswordQuality(ComponentName) y como devuelve y #getPasswordMinimumLength(ComponentName); si no cumple estas restricciones, se rechazará y se devolverá false. Tenga en cuenta que la contraseña puede ser una calidad más fuerte (que contiene caracteres alfanuméricos cuando la calidad solicitada es solo numérica), en cuyo caso se aumentará la calidad activa actualmente para que coincida.
En los dispositivos que no admiten PackageManager#FEATURE_SECURE_LOCK_SCREEN características, este método no hace nada.
El administrador del dispositivo que realiza la llamada debe haber solicitado DeviceAdminInfo#USES_POLICY_RESET_PASSWORD poder llamar a este método; si no lo tiene, se producirá una excepción de seguridad.
Este miembro está en desuso. Utilice #resetPasswordWithToken en su lugar.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.