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

ユーザーの新しいパスワード。 Null または空の場合、パスワードはクリアされます。

flags

ResetPasswordFlags

と を #RESET_PASSWORD_REQUIRE_ENTRY#RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT0 または組み合わせて使用できます。

戻り値

Boolean

パスワードが適用された場合は true、現在の制約で受け入れられない場合は false を返します。

属性

RegisterAttribute

注釈

デバイスのロック解除 (デバイス全体にアクセスするために必要なパスワード) または現在のユーザーの仕事用プロファイルチャレンジの新しいパスワードを強制します。 これは直ちに有効になります。

の前に android.os.Build.VERSION_CODES#N、この API はデバイス管理者、プロファイル所有者、およびデバイス所有者が使用できます。 以降 android.os.Build.VERSION_CODES#Nでは、レガシ デバイス管理者 (プロファイル所有者またはデバイス所有者でもない) は、この API を呼び出して、現在パスワードが設定されていない場合にのみ新しいパスワードを設定できます。 プロファイル所有者とデバイス所有者は、ターゲット ユーザーのロックが解除されている限り、既存のパスワードの変更を引き続き強制できます。ただし、デバイス上にマネージド プロファイルがある場合、デバイス所有者はこの API をまったく呼び出すことはできなくなります。

と の間android.os.Build.VERSION_CODES#Oで、この API を呼び出そうとする SDK レベルandroid.os.Build.VERSION_CODES#O以上を対象とするプロファイル所有者とデバイス所有者が受信SecurityExceptionします。代わりに新しい #resetPasswordWithToken API に移行することをお勧めします。 android.os.Build.VERSION_CODES#Pandroid.os.Build.VERSION_CODES#Q 以前の SDK レベルを対象とするプロファイル所有者とデバイス所有者は影響を受けず、前の段落で説明した既存の動作が引き続き発生します。

<em>以降android.os.Build.VERSION_CODES#Rでは、この API はほとんどの場合サポートされなくなりました。</em> この API を呼び出すデバイス所有者とプロファイル所有者は、SDK レベル以上を対象とする場合は受信します。または、低い SDK レベルandroid.os.Build.VERSION_CODES#Oをfalseターゲットとする場合はサイレント エラー (API が返す) を受けSecurityException取ります。 レガシ デバイス管理者の場合、この API は SDK レベルandroid.os.Build.VERSION_CODES#N以上を対象とする場合は スローSecurityExceptionし、それ以外の場合は を返しますfalse。 システム ファクトリ イメージの一部であるアクセス許可RESET_PASSWORD保持している特権アプリのみが、この API を呼び出して、現在パスワードが設定されていない場合に新しいパスワードを設定できます。 この場合、デバイスに既にパスワードがある場合、この API は をスロー SecurityExceptionします。

指定されたパスワードは、 および #getPasswordMinimumLength(ComponentName)によって#getPasswordQuality(ComponentName)返される現在のパスワードの品質と長さの制約に対して十分である必要があります。これらの制約を満たしていない場合は、拒否され、false が返されます。 パスワードは、より強力な品質 (要求された品質が数値のみの場合は英数字を含む) である可能性があることに注意してください。この場合、現在アクティブな品質は一致するように増加します。

機能をサポート PackageManager#FEATURE_SECURE_LOCK_SCREEN していないデバイスでは、この方法では何も行われません。

呼び出し元のデバイス管理者は、このメソッドを呼び出すことができるように要求 DeviceAdminInfo#USES_POLICY_RESET_PASSWORD している必要があります。呼び出されていない場合は、セキュリティ例外がスローされます。

このメンバーは非推奨とされます。 代わりに、#resetPasswordWithToken を使用してください。

の android.app.admin.DevicePolicyManager.resetPassword(java.lang.String, int)Java ドキュメント。

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