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_DO_NOT_ASK_CREDENTIALS_ON_BOOT的組合#RESET_PASSWORD_REQUIRE_ENTRY。

傳回

Boolean

如果套用密碼，則傳回 true;如果目前條件約束無法接受則傳回 false。

屬性

RegisterAttribute

備註

強制裝置解除鎖定的新密碼（存取整個裝置所需的密碼），或目前使用者的工作配置檔挑戰。 這會立即生效。

在 之前 android.os.Build.VERSION_CODES#N，此 API 可供裝置系統管理員、配置檔擁有者和裝置擁有者使用。 從 android.os.Build.VERSION_CODES#N開始，舊版裝置系統管理員（不是配置檔擁有者或裝置擁有者）只有在目前沒有密碼設定時，才能呼叫此 API 來設定新的密碼。 只要目標使用者解除鎖定，配置檔擁有者和裝置擁有者就可以繼續強制變更現有的密碼，但如果裝置上也有受控配置檔，裝置擁有者就完全無法呼叫此 API。

在、 與android.os.Build.VERSION_CODES#Q之間android.os.Build.VERSION_CODES#O，設定檔擁有者和以 SDK 層級或更新版本android.os.Build.VERSION_CODES#O為目標且嘗試呼叫此 API 的裝置擁有者會收到 SecurityException;建議您改為移轉至新的 #resetPasswordWithToken API。 android.os.Build.VERSION_CODES#P 以舊版 SDK 層級為目標的配置檔擁有者和裝置擁有者不會受到影響：它們會繼續體驗上一段所述的現有行為。

<em>從 android.os.Build.VERSION_CODES#R開始，大部分情況下都不再支援此 API。</em> 裝置擁有者和呼叫此 API 的配置檔擁有者會在目標為 SDK 層級或更新版本android.os.Build.VERSION_CODES#O時收到SecurityException，或者如果目標為較低 SDK 層級，則會收到無訊息失敗（API 傳false回）。 對於舊版裝置系統管理員，如果 API 是以 SDK 層級或更新版本android.os.Build.VERSION_CODES#N為目標，則擲SecurityException回 ，否則會傳false回 。 只有保留RESET_PASSWORD許可權的特殊許可權應用程式，系統處理站映像仍然可以呼叫此 API，以在目前沒有密碼設定時設定新密碼。 在這裡情況下，如果裝置已經有密碼，此 API 將會擲回 SecurityException。

指定的密碼必須足以滿足 和 #getPasswordMinimumLength(ComponentName)所#getPasswordQuality(ComponentName)傳回的目前密碼質量和長度條件約束;如果不符合這些條件約束，則會遭到拒絕並傳回 false。 請注意，當要求的品質只有數值時，密碼品質可能會更強（包含英數位元），在此情況下，目前的作用中品質將會增加以符合。

在不支援 PackageManager#FEATURE_SECURE_LOCK_SCREEN 功能的裝置上，此方法不會執行任何動作。

呼叫裝置系統管理員必須要求 DeviceAdminInfo#USES_POLICY_RESET_PASSWORD 能夠呼叫此方法;如果沒有，將會擲回安全性例外狀況。

已取代這個成員。 請改用 #resetPasswordWithToken。

的 android.app.admin.DevicePolicyManager.resetPassword(java.lang.String, int)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。