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

使用者的新密碼。 空或空則清除密碼。

flags

ResetPasswordFlags

可能是 0，或是 和 #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT的#RESET_PASSWORD_REQUIRE_ENTRY組合。

傳回

Boolean

若密碼已套用，則回傳真;若密碼不符合當前限制，則回傳假。

屬性

RegisterAttribute

備註

強制設定新密碼來解鎖裝置（存取整台裝置所需的密碼）或對現有使用者進行工作設定檔挑戰。 此規定立即生效。

在此之前 android.os.Build.VERSION_CODES#N，這個 API 是給裝置管理員、設定檔擁有者和裝置擁有者使用的。 從 android.os.Build.VERSION_CODES#N開始，舊裝置管理員（同時不是設定檔擁有者或裝置擁有者）只能在目前沒有設定密碼的情況下呼叫此 API 來設定新密碼。 只要目標使用者已解鎖，設定檔擁有者和裝置擁有者仍可強制更改現有密碼，但如果裝置上同時有受管理設定檔，裝置擁有者將無法呼叫此 API。

在 android.os.Build.VERSION_CODES#O、 和 android.os.Build.VERSION_CODES#Pandroid.os.Build.VERSION_CODES#Q之間，設定檔擁有者及目標 SDK 等級 android.os.Build.VERSION_CODES#O 以上的裝置擁有者若嘗試呼叫此 API，將收到 SecurityException;他們被鼓勵遷移至新 #resetPasswordWithToken API。 設定檔擁有者與裝置擁有者針對較舊 SDK 等級不會受影響：他們仍會體驗前一段所述的現有行為。

<em>從 android.os.Build.VERSION_CODES#R開始，這個 API 在大多數情況下已不再支援。</em> 裝置擁有者和設定檔擁有者呼叫此 API，若目標為 SDK 等級android.os.Build.VERSION_CODES#O或以上，則會收到SecurityException無聲失敗（API 回false傳）。 對於舊有裝置管理員，這個 API 會拋 SecurityException 棄他們是否針對 SDK 層級或更高層 android.os.Build.VERSION_CODES#N 級，否則則回傳 false 。 只有持有RESET_PASSWORD權限且屬於系統出廠映像的應用程式，如果目前沒有設定密碼，仍能呼叫此 API 設定新密碼。 在這種情況下，如果裝置已經有密碼，這個 API 會拋出 SecurityException。

給定密碼必須足夠滿足目前由 和 #getPasswordMinimumLength(ComponentName)回傳的#getPasswordQuality(ComponentName)密碼品質與長度限制;若不符合這些限制，則會被拒絕並錯誤回傳。 請注意，密碼可能是較強的品質（當請求的品質僅為數字時，包含字母數字），此時當前有效的品質會被提升以匹配。

在不支援 PackageManager#FEATURE_SECURE_LOCK_SCREEN 此功能的裝置上，這種方法毫無作用。

呼叫裝置管理員必須已申請能夠呼叫此方法;若未請求 DeviceAdminInfo#USES_POLICY_RESET_PASSWORD ，將拋出安全例外。

此會員已被棄用。 請改用 #resetPasswordWithToken。

Java 文件 android.app.admin.DevicePolicyManager.resetPassword(java.lang.String, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。