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

<em>以降android.os.Build.VERSION_CODES#R、ほとんどの場合、この API はサポートされなくなりました。<この API を呼び出す /em> デバイス所有者とプロファイル所有者は、ターゲット SDK レベル以上の場合は受信し、下位 SDK レベルandroid.os.Build.VERSION_CODES#Oをfalseターゲットとする場合はサイレント エラー (API が返されます) を受SecurityExceptionけ取ります。 レガシ デバイス管理者の場合、この 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 ドキュメントandroid.app.admin.DevicePolicyManager.resetPassword(java.lang.String, int)

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。