다음을 통해 공유


DevicePolicyManager.ResetPassword(String, ResetPasswordFlags) 메서드

정의

디바이스 잠금 해제에 대한 새 암호(전체 디바이스에 액세스하는 데 필요한 암호) 또는 현재 사용자의 회사 프로필 챌린지를 강제로 적용합니다.

[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

매개 변수

password
String

사용자의 새 암호입니다. Null 또는 빈 암호를 지웁니다.

flags
ResetPasswordFlags

0 또는 의 조합 #RESET_PASSWORD_REQUIRE_ENTRY 일 수 있습니다 #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT.

반환

암호가 적용된 경우 true를 반환하고, 현재 제약 조건에 허용되지 않는 경우 false를 반환합니다.

특성

설명

디바이스 잠금 해제에 대한 새 암호(전체 디바이스에 액세스하는 데 필요한 암호) 또는 현재 사용자의 회사 프로필 챌린지를 강제로 적용합니다. 이 작업은 즉시 적용됩니다.

이전에는 android.os.Build.VERSION_CODES#N디바이스 관리자, 프로필 소유자 및 디바이스 소유자가 이 API를 사용할 수 있습니다. android.os.Build.VERSION_CODES#N먼저 레거시 디바이스 관리자(프로필 소유자 또는 디바이스 소유자도 아님)는 현재 암호 집합이 없는 경우에만 이 API를 호출하여 새 암호를 설정할 수 있습니다. 디바이스에 관리 프로필이 있는 경우 디바이스 소유자가 이 API를 전혀 호출할 수 없지만, 프로필 소유자와 디바이스 소유자는 대상 사용자의 잠금을 해제하는 한 기존 암호를 계속 강제로 변경할 수 있습니다.

android.os.Build.VERSION_CODES#P android.os.Build.VERSION_CODES#Q이 API를 호출하려고 시도하는 SDK 수준 android.os.Build.VERSION_CODES#O 이상을 대상으로 하는 프로필 소유자와 디바이스 소유자 간에 android.os.Build.VERSION_CODES#O새 APISecurityException로 마이그레이션하는 #resetPasswordWithToken 것이 좋습니다. 이전 SDK 수준을 대상으로 하는 프로필 소유자 및 디바이스 소유자는 영향을 받지 않습니다. 이전 단락에서 설명한 기존 동작을 계속 경험합니다.

<em>시작부터 android.os.Build.VERSION_CODES#R이 API는 대부분의 경우 더 이상 지원되지 않습니다.</em> 이 API를 호출하는 디바이스 소유자 및 프로필 소유자는 SDK 수준 이상을 대상으로 하는 경우 수신되거나, 낮은 SDK 수준을 android.os.Build.VERSION_CODES#O 대상으로 하는 경우 자동 오류(API 반환false)를 받게 SecurityException 됩니다. 레거시 디바이스 관리자의 경우 이 API는 SDK 수준 android.os.Build.VERSION_CODES#N 이상을 대상으로 하는 경우 throw SecurityException 하고, 그렇지 않으면 반환합니다false. 시스템 팩터리 이미지의 일부인 RESET_PASSWORD 권한을 보유한 권한 있는 앱만 이 API를 호출하여 현재 암호 집합이 없는 경우 새 암호를 설정할 수 있습니다. 이 경우 디바이스에 이미 암호가 있는 경우 이 API가 throw SecurityException됩니다.

지정된 암호는 반환 #getPasswordQuality(ComponentName) #getPasswordMinimumLength(ComponentName)된 현재 암호 품질 및 길이 제약 조건에 충분해야 합니다. 이러한 제약 조건을 충족하지 않으면 거부되고 false로 반환됩니다. 암호는 더 강력한 품질일 수 있습니다(요청된 품질이 숫자일 때 영숫자 문자 포함). 이 경우 현재 활성 품질이 일치하도록 증가합니다.

기능을 지원하지 PackageManager#FEATURE_SECURE_LOCK_SCREEN 않는 디바이스에서 이 메서드는 아무 작업도 수행하지 않습니다.

호출 디바이스 관리자가 이 메서드를 호출할 수 있도록 요청 DeviceAdminInfo#USES_POLICY_RESET_PASSWORD 해야 합니다. 그렇지 않은 경우 보안 예외가 throw됩니다.

이 멤버는 더 이상 사용되지 않습니다. 대신 #resetPasswordWithToken를 사용하십시오.

에 대한 android.app.admin.DevicePolicyManager.resetPassword(java.lang.String, int)Java 설명서

이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.

적용 대상