DevicePolicyManager.ResetPasswordWithToken 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
由设备或配置文件所有者调用,以强制对当前用户设置新的设备解锁密码或托管配置文件质询。
[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。
- 特性
注解
由设备或配置文件所有者调用,以强制对当前用户设置新的设备解锁密码或托管配置文件质询。 这会立即生效。
与此 API 不同 #resetPassword,即使在解锁或解密用户或设备之前,此 API 也可以更改密码。 提供的令牌必须以前通过 #setResetPasswordToken且处于活动状态 #isResetPasswordTokenActive进行预配。
给定的密码必须足以满足所返回#getPasswordQuality(ComponentName)#getPasswordMinimumLength(ComponentName)的当前密码质量和长度约束;如果它不符合这些约束,则将被拒绝并返回 false。 请注意,密码质量可能更强,例如,当请求的质量仅为数字时,包含字母数字字符的密码。
如果当前密码限制允许,则使用 null 或空密码进行调用将清除任何现有的 PIN、模式或密码。
在不支持 PackageManager#FEATURE_SECURE_LOCK_SCREEN 此功能的设备上,调用此方法不起作用 -- 密码始终为空 ,并返回 false。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。