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

備註

將此值設定為大於零的值，可啟用在輸入太多不正確的裝置解除鎖定密碼之後，執行裝置或配置檔抹除的原則。 此原則結合了監看失敗的密碼和抹除裝置，並要求呼叫 Device Admins 要求 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 功能的裝置上，密碼一律是空的，而且這個方法沒有作用，也就是未設定原則。

的 android.app.admin.DevicePolicyManager.setMaximumFailedPasswordsForWipe(android.content.ComponentName, int)Java 檔。

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