DevicePolicyManager.SetPasswordQuality(ComponentName, PasswordQuality) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
由管理該裝置的應用程式呼叫來設定它所施加的密碼限制。
[Android.Runtime.Register("setPasswordQuality", "(Landroid/content/ComponentName;I)V", "GetSetPasswordQuality_Landroid_content_ComponentName_IHandler")]
public virtual void SetPasswordQuality(Android.Content.ComponentName admin, Android.App.Admin.PasswordQuality quality);[<Android.Runtime.Register("setPasswordQuality", "(Landroid/content/ComponentName;I)V", "GetSetPasswordQuality_Landroid_content_ComponentName_IHandler")>]
abstract member SetPasswordQuality : Android.Content.ComponentName * Android.App.Admin.PasswordQuality -> unit
override this.SetPasswordQuality : Android.Content.ComponentName * Android.App.Admin.PasswordQuality -> unit參數
- admin
- ComponentName
這個請求就是和這個 DeviceAdminReceiver 問題有關的。
- quality
- PasswordQuality
新的渴望品質。 其中之一為 #PASSWORD_QUALITY_UNSPECIFIED、 #PASSWORD_QUALITY_BIOMETRIC_WEAK、 #PASSWORD_QUALITY_SOMETHING、 #PASSWORD_QUALITY_NUMERIC#PASSWORD_QUALITY_ALPHANUMERIC#PASSWORD_QUALITY_NUMERIC_COMPLEX#PASSWORD_QUALITY_ALPHABETIC#PASSWORD_QUALITY_COMPLEX或 。
- 屬性
備註
由管理該裝置的應用程式呼叫來設定它所施加的密碼限制。 設定此後，使用者將無法輸入不像原本設定那麼嚴格的新密碼。 請注意，目前的密碼會保留，直到使用者設定新密碼為止，因此更改不會立即生效。 要提示使用者輸入新密碼，請使用 #ACTION_SET_NEW_PASSWORD 或 #ACTION_SET_NEW_PARENT_PROFILE_PASSWORD 在呼叫此方法後使用。
品質常數的排序使得較高的數值限制性更高;因此，最高請求的品質常數（在此策略設定、使用者偏好及其他考量之間）即為生效的常數。
在不支援 PackageManager#FEATURE_SECURE_LOCK_SCREEN 此功能的裝置上，密碼總是被視為空的。
呼叫裝置管理員必須已申請能夠呼叫此方法;若未請求 DeviceAdminInfo#USES_POLICY_LIMIT_PASSWORD ，將拋出安全例外。
應用程式android.os.Build.VERSION_CODES#R目標鎖定及以下，可以在回傳#getParentProfileInstance(ComponentName)的實例上呼叫此方法DevicePolicyManager，以設定父檔案的限制。 應用程式目標鎖定android.os.Build.VERSION_CODES#S及以上，除非是組織擁有的裝置上的設定檔擁有者（可由 #isOrganizationOwnedDeviceWithManagedProfile可辨識），在父實例呼叫此方法DevicePolicyManager時會獲得 aIllegalArgumentException。
<強註>：</strong> 使用此方法指定密碼要求可解除密碼複雜度要求。#setRequiredPasswordComplexity(int) 若此方法在由 返回#getParentProfileInstance(ComponentName)的實例中被呼叫DevicePolicyManager，則必須先#setRequiredPasswordComplexity透過 #PASSWORD_COMPLEXITY_NONE） 呼叫來清除主密碼DevicePolicyManager的複雜度要求。
<p><字串>注意：</strong> 這個方法在 {PackageManager#FEATURE_AUTOMOTIVE 汽車組裝中被忽略。
此會員已被棄用。 建議使用 #setRequiredPasswordComplexity(int)，以要求符合平台定義複雜度等級的密碼，而非指定自訂密碼要求。 設定過於複雜的自訂密碼要求會導致使用者難以記住的密碼，且可能無法帶來任何安全效益，因為 Android 採用硬體支援的限速機制來阻止線上與離線暴力破解裝置螢幕鎖定。 公司擁有的裝置（全管理及組織擁有的管理型態裝置）仍可繼續使用此方法，但建議 #setRequiredPasswordComplexity(int) 採用此方法。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。