語言

DevicePolicyManager.ResetPasswordWithToken 方法

定義

命名空間:
Android.App.Admin
組件:
Mono.Android.dll

裝置或設定檔擁有者呼叫，強制設定新裝置解鎖密碼或對現有使用者進行管理式設定檔挑戰。

[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 或是 empty 會清除密碼。

token
Byte[]

先前由 #setResetPasswordToken配置的密碼重設令牌。

flags
ResetPasswordFlags

可能是 0，或是 和 #RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT的#RESET_PASSWORD_REQUIRE_ENTRY組合。

傳回

Boolean

若密碼已套用，則回傳真;若密碼不符合當前限制，則回傳假。

屬性
RegisterAttribute RequiresPermissionAttribute

備註

裝置或設定檔擁有者呼叫，強制設定新裝置解鎖密碼或對現有使用者進行管理式設定檔挑戰。 此規定立即生效。

與 #resetPassword不同，這個 API 可以在使用者或裝置尚未解鎖或解密前就更改密碼。 所提供的令牌必須事先透過 配置 #setResetPasswordToken，且處於活躍狀態 #isResetPasswordTokenActive。

給定密碼必須足夠滿足目前由 和 #getPasswordMinimumLength(ComponentName)回傳的#getPasswordQuality(ComponentName)密碼品質與長度限制;若不符合這些限制，則會被拒絕並錯誤回傳。 請注意，密碼品質可能更強，例如當請求的品質僅為數字時，密碼包含字母數字。

若 null 密碼限制允許，使用空密碼撥打電話即可清除任何現有的 PIN、模式或密碼。

在不支援 PackageManager#FEATURE_SECURE_LOCK_SCREEN 此功能的裝置上，呼叫此方法無效——密碼永遠為空，且回傳 false。

Java 文件 android.app.admin.DevicePolicyManager.resetPasswordWithToken(android.content.ComponentName, java.lang.String, byte[], int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於