DevicePolicyManager.ResetPassword(String, ResetPasswordFlags) 메서드

정의

네임스페이스:

Android.App.Admin

어셈블리:

Mono.Android.dll

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

[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 또는 empty는 암호를 지웁니다.

flags

ResetPasswordFlags

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

반환

Boolean

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

특성

RegisterAttribute

설명

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

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

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

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

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

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

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

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

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

이 페이지의 일부는 만들고 공유하며 에 설명된 용어에 따라 사용되는 작업을 기반으로 수정됩니다.