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 или пустое очищает пароль.

flags

ResetPasswordFlags

Может быть 0 или сочетание #RESET_PASSWORD_REQUIRE_ENTRY и #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT.

Возвращаемое значение

Boolean

Возвращает значение true, если пароль был применен или false, если он не допускается для текущих ограничений.

Атрибуты

RegisterAttribute

Комментарии

Принудительно заставить новый пароль для разблокировки устройства (пароль, необходимый для доступа ко всему устройству) или вызов рабочего профиля для текущего пользователя. Это вступает в силу немедленно.

Прежде чем android.os.Build.VERSION_CODES#Nэтот API доступен администратору устройства, владельцу профиля и владельцу устройства. Начиная с android.os.Build.VERSION_CODES#Nустаревшего администратора устройства (который также не является владельцем профиля или владельцем устройства) можно вызвать только этот API, чтобы задать новый пароль, если в настоящее время нет набора паролей. Владелец профиля и владелец устройства могут продолжать принудительно изменять существующий пароль до тех пор, пока целевой пользователь разблокирован, хотя владелец устройства не сможет вызывать этот API вообще, если на устройстве также есть управляемый профиль.

android.os.Build.VERSION_CODES#Qandroid.os.Build.VERSION_CODES#P Между android.os.Build.VERSION_CODES#Oвладельцем профиля и владельцем устройств, предназначенным для уровня android.os.Build.VERSION_CODES#O ПАКЕТА SDK или выше, который пытается вызвать этот API, рекомендуется перейти на новый #resetPasswordWithToken APISecurityException. Владелец профиля и владелец устройства, предназначенные для более старых уровней пакета SDK, не затрагиваются: они продолжают испытывать существующее поведение, описанное в предыдущем абзаце.

<Em>Начиная с android.os.Build.VERSION_CODES#Rэтого API больше не поддерживается в большинстве случаев.</em> Владелец устройства и владелец профиля, вызывающий этот API, получит, SecurityException если он предназначен для уровня android.os.Build.VERSION_CODES#O ПАКЕТА SDK или выше, или он получит автоматический сбой (возвращаемый falseAPI), если они нацелены на более низкий уровень ПАКЕТА SDK. Для устаревших администраторов устройств этот API создает исключение SecurityException , если он предназначен для уровня android.os.Build.VERSION_CODES#N ПАКЕТА SDK или более поздней версии, и возвращается false в противном случае. Только привилегированные приложения с разрешением RESET_PASSWORD, которые являются частью образа системной фабрики, по-прежнему могут вызывать этот API, чтобы задать новый пароль, если в настоящее время нет набора паролей. В этом случае, если у устройства уже есть пароль, этот API вызовет SecurityExceptionисключение.

Заданный пароль должен быть достаточно для текущих ограничений качества и длины паролей, возвращаемых #getPasswordQuality(ComponentName) и #getPasswordMinimumLength(ComponentName); если он не соответствует этим ограничениям, то он будет отклонен и ложно возвращен. Обратите внимание, что пароль может быть более сильным качеством (содержащий буквенно-цифровые символы, если запрошенное качество является только числовым), в этом случае текущее активное качество будет увеличено для сопоставления.

На устройствах, не поддерживающих функцию PackageManager#FEATURE_SECURE_LOCK_SCREEN , эти методы ничего не делает.

Администратор вызывающего устройства должен иметь DeviceAdminInfo#USES_POLICY_RESET_PASSWORD возможность вызывать этот метод; если он не имеет, создается исключение безопасности.

Этот элемент считается нерекомендуемым. Взамен рекомендуется использовать #resetPasswordWithToken.

Документация по Java для android.app.admin.DevicePolicyManager.resetPassword(java.lang.String, int).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.