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

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

Atributos

RegisterAttribute

Comentários

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

Antes android.os.Build.VERSION_CODES#Ndo , essa API está disponível para o administrador do dispositivo, o proprietário do perfil e o proprietário do dispositivo. A partir do , o administrador do dispositivo herdado (que também não é proprietário do android.os.Build.VERSION_CODES#Nperfil ou do dispositivo) só pode chamar essa API para definir uma nova senha se não houver nenhuma senha definida 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 possa chamar essa API se também houver um perfil gerenciado no dispositivo.

Entre android.os.Build.VERSION_CODES#O, android.os.Build.VERSION_CODES#P e android.os.Build.VERSION_CODES#Q, o proprietário do perfil e o proprietário dos dispositivos que visam o nível android.os.Build.VERSION_CODES#O do SDK ou acima que tentarem chamar essa API receberão o que eles são SecurityExceptionincentivados 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 , esta API não é mais suportada android.os.Build.VERSION_CODES#Rna maioria dos casos.</em> O proprietário do dispositivo e o proprietário do perfil que chamar essa API receberão SecurityException se tiverem como alvo o nível android.os.Build.VERSION_CODES#O do SDK ou superior, ou receberão uma falha silenciosa (retorno falseda API) se tiverem como alvo o nível inferior do SDK. Para administradores de SecurityException dispositivos herdados, essa API é lançada se eles visam o nível android.os.Build.VERSION_CODES#N do SDK ou superior e retorna false de outra forma. Somente aplicativos privilegiados com permissão RESET_PASSWORD que fazem parte da imagem de fábrica do sistema ainda podem chamar essa API para definir uma nova senha se não houver nenhuma senha definida no momento. Nesse caso, se o dispositivo já tiver uma senha, essa API lançará SecurityException.

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

Em dispositivos que não oferecem suporte ao PackageManager#FEATURE_SECURE_LOCK_SCREEN recurso, esse método não faz nada.

O administrador do dispositivo de chamada deve ter solicitado DeviceAdminInfo#USES_POLICY_RESET_PASSWORD para poder chamar esse método, se não o fizer, uma exceção de segurança será lançada.

Este membro foi preterido. Use #resetPasswordWithToken em vez disso.

Documentação Java 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 Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a