Language

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_REQUIRE_ENTRY と #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOTの組み合わせであってもよい。

返品

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

属性

注釈

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

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

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

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

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

Javaドキュメント。

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

適用対象