Language

DevicePolicyManager.SetPasswordQuality(ComponentName, PasswordQuality) メソッド

定義

名前空間:
Android.App.Admin
アセンブリ:
Mono.Android.dll

デバイスを管理しているアプリケーションによって呼び出され、適用されるパスワード制限を設定します。

[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_NUMERIC_COMPLEX、#PASSWORD_QUALITY_ALPHABETIC、#PASSWORD_QUALITY_ALPHANUMERIC、または#PASSWORD_QUALITY_COMPLEXのいずれか。

属性
RegisterAttribute

注釈

デバイスを管理しているアプリケーションによって呼び出され、適用されるパスワード制限を設定します。 これを設定した後、ユーザーは、少なくとも設定されたパスワードほど制限のない新しいパスワードを入力できなくなります。 現在のパスワードは、ユーザーが新しいパスワードを設定するまで保持されるため、変更はすぐには行われません。 ユーザーに新しいパスワードの入力を求めるメッセージを表示するには、このメソッドを呼び出した後、 #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 インスタンスでこのメソッドを呼び出すと、IllegalArgumentExceptionが取得されます。

<strong>Note:</strong> この方法を使用してパスワード要件を指定すると、 #setRequiredPasswordComplexity(int)を使用して設定されたパスワードの複雑さの要件がクリアされます。 #getParentProfileInstance(ComponentName)によって返されるDevicePolicyManager インスタンスでこのメソッドを呼び出す場合は、最初に #PASSWORD_COMPLEXITY_NONE) を使用して#setRequiredPasswordComplexityを呼び出すことによって、プライマリ DevicePolicyManagerに設定されたパスワードの複雑さの要件を最初にクリアする必要があります。

<p><string>Note:</strong> このメソッドは{PackageManager#FEATURE_AUTOMOTIVE車載ビルドでは無視。

このメンバーは非推奨です。 カスタム パスワード要件を指定するのではなく、プラットフォームによって定義された複雑さのレベルを満たすパスワードを要求するには、 #setRequiredPasswordComplexity(int)を使用することをお選びください。 カスタムの過度に複雑なパスワード要件を設定すると、ユーザーが覚えにくいパスワードになり、Android ではハードウェアによる調整を使用して、デバイスの画面ロックのオンラインとオフラインのブルートフォースを阻止するため、セキュリティ上の利点が得られない可能性があります。 会社所有のデバイス (フル マネージドおよび組織所有のマネージド プロファイル デバイス) は、この方法を引き続き使用できますが、代わりに #setRequiredPasswordComplexity(int) を使用することをお勧めします。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象