Language

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

0または #RESET_PASSWORD_REQUIRE_ENTRY と #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOTの組み合わせであってもよい。

返品

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

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

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

PackageManager#FEATURE_SECURE_LOCK_SCREEN機能をサポートしていないデバイスでは、このメソッドは何も行いません。

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

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

Javaドキュメント。

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

適用対象