DevicePolicyManager.ResetPassword(String, ResetPasswordFlags) Método

[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

Parâmetros

Retornos

Retornará true se a senha tiver sido aplicada ou false se não for aceitável para as restrições atuais.

Atributos

RegisterAttribute

Comentários

Force uma nova senha para o desbloqueio do dispositivo (a senha necessária para acessar todo o dispositivo) ou o desafio de perfil de trabalho no usuário atual. Isso entra em vigor imediatamente.

Antes android.os.Build.VERSION_CODES#N, essa API está disponível para administrador do dispositivo, proprietário do perfil e proprietário do dispositivo. A partir daí, o administrador do android.os.Build.VERSION_CODES#Ndispositivo herdado (que também não é proprietário do perfil ou proprietário do dispositivo) só poderá chamar essa API para definir uma nova senha se não houver nenhum conjunto de senhas no momento. O proprietário do perfil e o proprietário do dispositivo podem continuar a forçar a alteração de uma senha existente, desde que o usuário de destino seja desbloqueado, embora o proprietário do dispositivo não consiga chamar essa API se também houver um perfil gerenciado no dispositivo.

Entre android.os.Build.VERSION_CODES#Oo android.os.Build.VERSION_CODES#P proprietário do perfil e android.os.Build.VERSION_CODES#Qo proprietário dos dispositivos direcionados ao nível android.os.Build.VERSION_CODES#O do SDK ou superior que tentar chamar essa API receberão SecurityException; eles são incentivados a migrar para a nova #resetPasswordWithToken API. O proprietário do perfil e o proprietário do dispositivo direcionados a níveis de SDK mais antigos não são afetados: eles continuam a experimentar o comportamento existente descrito no parágrafo anterior.

<em>A partir de android.os.Build.VERSION_CODES#Rentão, essa API não tem mais suporte na maioria dos casos.</em> O proprietário do dispositivo e o proprietário do perfil que chamar essa API receberão SecurityException se forem direcionados ao nível android.os.Build.VERSION_CODES#O do SDK ou superior, ou receberão uma falha silenciosa (API retornando false) se forem direcionados ao nível inferior do SDK. Para administradores de dispositivo herdados, essa API será gerada se eles forem direcionados SecurityException ao nível android.os.Build.VERSION_CODES#N do SDK ou superior e retornarem false de outra forma. Somente aplicativos privilegiados com RESET_PASSWORD permissão que fazem parte da imagem do system factory ainda poderão chamar essa API para definir uma nova senha se não houver nenhum conjunto de senhas no momento. Nesse caso, se o dispositivo já tiver uma senha, essa API será lançada SecurityException.

A senha fornecida deve ser suficiente para as restrições de qualidade e comprimento da senha atual, conforme retornado #getPasswordQuality(ComponentName) e #getPasswordMinimumLength(ComponentName); se ela não atender a essas restrições, ela será rejeitada e falsa retornada. Observe que a senha pode ser uma qualidade mais forte (contendo caracteres alfanuméricos quando a qualidade solicitada é apenas numérica), nesse caso, a qualidade ativa atualmente será aumentada para corresponder.

Em dispositivos que não dão PackageManager#FEATURE_SECURE_LOCK_SCREEN suporte ao recurso, esses métodos não fazem nada.

O administrador do dispositivo de chamada deve ter solicitado DeviceAdminInfo#USES_POLICY_RESET_PASSWORD ser capaz de chamar esse método; se não tiver, uma exceção de segurança será gerada.

Este membro foi preterido. Use #resetPasswordWithToken em seu lugar.

Java documentação para android.app.admin.DevicePolicyManager.resetPassword(java.lang.String, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.