語言

DevicePolicyManager.SetMaximumFailedPasswordsForWipe 方法

定義

命名空間:
Android.App.Admin
組件:
Mono.Android.dll

將此值設為大於零，則可啟動政策，在輸入過多錯誤的裝置解鎖密碼後，執行裝置或個人資料清除。

[Android.Runtime.Register("setMaximumFailedPasswordsForWipe", "(Landroid/content/ComponentName;I)V", "GetSetMaximumFailedPasswordsForWipe_Landroid_content_ComponentName_IHandler")]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_WIPE_DATA")]
public virtual void SetMaximumFailedPasswordsForWipe(Android.Content.ComponentName? admin, int num);
[<Android.Runtime.Register("setMaximumFailedPasswordsForWipe", "(Landroid/content/ComponentName;I)V", "GetSetMaximumFailedPasswordsForWipe_Landroid_content_ComponentName_IHandler")>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_WIPE_DATA")>]
abstract member SetMaximumFailedPasswordsForWipe : Android.Content.ComponentName * int -> unit
override this.SetMaximumFailedPasswordsForWipe : Android.Content.ComponentName * int -> unit

參數

admin
ComponentName

這個請求就是和這個 DeviceAdminReceiver 問題有關的。 如果呼叫者不是裝置管理員，則為 Null。

num
Int32

密碼嘗試失敗次數，當裝置或設定檔會被清除時。

屬性
RegisterAttribute RequiresPermissionAttribute

備註

將此值設為大於零，則可啟動政策，在輸入過多錯誤的裝置解鎖密碼後，執行裝置或個人資料清除。 此政策結合了監控密碼失敗與清除裝置，並要求呼叫裝置管理員同時請求 DeviceAdminInfo#USES_POLICY_WATCH_LOGIN 和 DeviceAdminInfo#USES_POLICY_WIPE_DATA}。

當系統或主要使用者設定此政策時，裝置會因多次密碼錯誤嘗試而被恢復出廠設定。 當設定在任何其他使用者身上時，只有對應的使用者或設定檔會被清除。

要實作其他政策（例如只清除特定應用程式的資料、刪除或撤銷憑證，或向伺服器回報失敗），你應該先實作 DeviceAdminReceiver#onPasswordFailed(Context, android.content.Intent) 。 請勿使用此 API，因為一旦達到最大數值，裝置或設定檔將立即被清除，且回撥不會被啟動。

此方法可在回傳#getParentProfileInstance(ComponentName)的實例中呼叫DevicePolicyManager，以設定父設定檔值。 即使每個設定檔有獨立挑戰，當父設定檔輸入過多錯誤的解鎖密碼後，仍可進行個人檔案清除。

在不支援 PackageManager#FEATURE_SECURE_LOCK_SCREEN 此功能的裝置上，密碼永遠為空，此方法無效——也就是說政策未被設定。

Java 文件 android.app.admin.DevicePolicyManager.setMaximumFailedPasswordsForWipe(android.content.ComponentName, int)。

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

適用於