DevicePolicyManager.ResetPasswordWithToken メソッド

定義

デバイスまたはプロファイル所有者によって呼び出され、現在のユーザーに新しいデバイスロック解除パスワードまたはマネージド プロファイルチャレンジを強制的に設定します。

[Android.Runtime.Register("resetPasswordWithToken", "(Landroid/content/ComponentName;Ljava/lang/String;[BI)Z", "GetResetPasswordWithToken_Landroid_content_ComponentName_Ljava_lang_String_arrayBIHandler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_RESET_PASSWORD")]
public virtual bool ResetPasswordWithToken (Android.Content.ComponentName? admin, string? password, byte[]? token, Android.App.Admin.ResetPasswordFlags flags);
[<Android.Runtime.Register("resetPasswordWithToken", "(Landroid/content/ComponentName;Ljava/lang/String;[BI)Z", "GetResetPasswordWithToken_Landroid_content_ComponentName_Ljava_lang_String_arrayBIHandler", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_RESET_PASSWORD")>]
abstract member ResetPasswordWithToken : Android.Content.ComponentName * string * byte[] * Android.App.Admin.ResetPasswordFlags -> bool
override this.ResetPasswordWithToken : Android.Content.ComponentName * string * byte[] * Android.App.Admin.ResetPasswordFlags -> bool

パラメーター

admin
ComponentName

DeviceAdminReceiverこの要求が関連付けられているもの。 呼び出し元がデバイス管理者でない場合は Null。

password
String

ユーザーの新しいパスワード。 null または 空にすると、パスワードがクリアされます。

token
Byte[]

によって #setResetPasswordToken以前にプロビジョニングされたパスワード リセット トークン。

flags
ResetPasswordFlags

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

戻り値

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

属性

注釈

デバイスまたはプロファイル所有者によって呼び出され、現在のユーザーに新しいデバイスロック解除パスワードまたはマネージド プロファイルチャレンジを強制的に設定します。 これはすぐに有効になります。

とは異なり #resetPassword、この API は、ユーザーまたはデバイスのロックが解除または復号化される前でもパスワードを変更できます。 指定されたトークンは、以前に を介して #setResetPasswordTokenプロビジョニングされ、アクティブな状態 #isResetPasswordTokenActiveである必要があります。

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

または空のパスワードを null 使用してを呼び出すと、現在のパスワード制約で許可されている場合、既存の PIN、パターン、またはパスワードがクリアされます。

機能をサポート PackageManager#FEATURE_SECURE_LOCK_SCREEN していないデバイスでは、このメソッドを呼び出しても効果はありません。パスワードは常に空で、false が返されます。

の Java ドキュメント android.app.admin.DevicePolicyManager.resetPasswordWithToken(android.content.ComponentName, java.lang.String, byte[], int)

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

適用対象