DevicePolicyManager.ResetPassword(String, ResetPasswordFlags) Metodo

Riferimento

Definizione

Spazio dei nomi:: Android.App.Admin

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Forzare una nuova password per lo sblocco del dispositivo (la password necessaria per accedere all'intero dispositivo) o la richiesta di verifica del profilo di lavoro sull'utente corrente.

[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

Parametri

password: String

Nuova password per l'utente. Null o vuoto cancella la password.

flags: ResetPasswordFlags

Può essere 0 o combinazione di #RESET_PASSWORD_REQUIRE_ENTRY e #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT.

Restituisce

Boolean

Restituisce true se la password è stata applicata o false se non è accettabile per i vincoli correnti.

Attributi: RegisterAttribute

Commenti

Forzare una nuova password per lo sblocco del dispositivo (la password necessaria per accedere all'intero dispositivo) o la richiesta di verifica del profilo di lavoro sull'utente corrente. Questa operazione diventa effettiva immediatamente.

Prima android.os.Build.VERSION_CODES#Ndi , questa API è disponibile per l'amministratore del dispositivo, il proprietario del profilo e il proprietario del dispositivo. A partire da android.os.Build.VERSION_CODES#N, l'amministratore del dispositivo legacy (che non è anche proprietario del profilo o proprietario del dispositivo) può chiamare questa API solo per impostare una nuova password se non è attualmente disponibile alcun set di password. Il proprietario del profilo e il proprietario del dispositivo possono continuare a forzare la modifica di una password esistente purché l'utente di destinazione venga sbloccato, anche se il proprietario del dispositivo non sarà in grado di chiamare questa API se è presente anche un profilo gestito nel dispositivo.

Tra android.os.Build.VERSION_CODES#O, android.os.Build.VERSION_CODES#P e android.os.Build.VERSION_CODES#Q, il proprietario del profilo e il proprietario dei dispositivi destinati al livello android.os.Build.VERSION_CODES#O SDK o superiore a chi tenta di chiamare questa API riceverà SecurityException. È invece consigliabile eseguire la migrazione alla nuova #resetPasswordWithToken API. Il proprietario del profilo e il proprietario del dispositivo destinati ai livelli SDK meno recenti non sono interessati: continuano a sperimentare il comportamento esistente descritto nel paragrafo precedente.

<em>A partire da android.os.Build.VERSION_CODES#R, questa API non è più supportata nella maggior parte dei casi.<> Il proprietario del dispositivo e il proprietario del profilo che chiamano questa API riceveranno SecurityException se hanno come destinazione il livello SDK o superiore o riceveranno un errore invisibile all'utente (API che restituisce false) se hanno come destinazione un livello android.os.Build.VERSION_CODES#O SDK inferiore. Per gli amministratori di dispositivi legacy, questa API genera SecurityException un'eccezione se ha come destinazione il livello android.os.Build.VERSION_CODES#N SDK o superiore e restituisce false in caso contrario. Solo le app con privilegi che contengono RESET_PASSWORD autorizzazione che fanno parte dell'immagine della factory di sistema possono comunque chiamare questa API per impostare una nuova password se non è attualmente disponibile alcun set di password. In questo caso, se il dispositivo ha già una password, questa API genererà SecurityException.

La password specificata deve essere sufficiente per i vincoli di lunghezza e qualità della password correnti restituiti da #getPasswordQuality(ComponentName) e #getPasswordMinimumLength(ComponentName). Se non soddisfa questi vincoli, verrà rifiutato e restituito false. Si noti che la password può essere una qualità più elevata (contenente caratteri alfanumerici quando la qualità richiesta è solo numerica), nel qual caso la qualità attualmente attiva verrà aumentata per la corrispondenza.

Nei dispositivi che non supportano PackageManager#FEATURE_SECURE_LOCK_SCREEN la funzionalità, questo metodo non esegue alcuna operazione.

L'amministratore del dispositivo chiamante deve aver richiesto DeviceAdminInfo#USES_POLICY_RESET_PASSWORD di poter chiamare questo metodo. In caso contrario, verrà generata un'eccezione di sicurezza.

Questo membro è deprecato. Usare invece #resetPasswordWithToken.

Documentazione java per android.app.admin.DevicePolicyManager.resetPassword(java.lang.String, int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a

Condividi tramite