DevicePolicyManager.ResetPassword(String, ResetPasswordFlags) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
디바이스 잠금 해제에 대한 새 암호(전체 디바이스에 액세스하는 데 필요한 암호) 또는 현재 사용자의 회사 프로필 챌린지를 강제로 적용합니다.
[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 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.