語言

DevicePolicyManager.SetTrustAgentConfiguration 方法

定義

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

設定一套配置功能清單，以啟用信任代理元件。

[Android.Runtime.Register("setTrustAgentConfiguration", "(Landroid/content/ComponentName;Landroid/content/ComponentName;Landroid/os/PersistableBundle;)V", "GetSetTrustAgentConfiguration_Landroid_content_ComponentName_Landroid_content_ComponentName_Landroid_os_PersistableBundle_Handler", ApiSince=23)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_KEYGUARD")]
public virtual void SetTrustAgentConfiguration(Android.Content.ComponentName? admin, Android.Content.ComponentName target, Android.OS.PersistableBundle? configuration);
[<Android.Runtime.Register("setTrustAgentConfiguration", "(Landroid/content/ComponentName;Landroid/content/ComponentName;Landroid/os/PersistableBundle;)V", "GetSetTrustAgentConfiguration_Landroid_content_ComponentName_Landroid_content_ComponentName_Landroid_os_PersistableBundle_Handler", ApiSince=23)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_KEYGUARD")>]
abstract member SetTrustAgentConfiguration : Android.Content.ComponentName * Android.Content.ComponentName * Android.OS.PersistableBundle -> unit
override this.SetTrustAgentConfiguration : Android.Content.ComponentName * Android.Content.ComponentName * Android.OS.PersistableBundle -> unit

參數

admin
ComponentName

這個請求就是和這個 DeviceAdminReceiver 問題有關的。 如果呼叫者不是裝置管理員，則為空

target
ComponentName

要設定代理的元件名稱。

configuration
PersistableBundle

信任代理專屬功能配置套件。 請查閱特定信託代理人的文件以確定此組合的解釋。

屬性
RegisterAttribute RequiresPermissionAttribute

備註

設定一套配置功能清單，以啟用信任代理元件。 此功能應與 結合使用 #KEYGUARD_DISABLE_TRUST_AGENTS，該功能禁用除此函式呼叫啟用的所有信任代理外。 若未設定旗標 #KEYGUARD_DISABLE_TRUST_AGENTS ，則此通話無效。

對於任何特定的信任代理，是否被停用取決於每個管理員 #KEYGUARD_DISABLE_TRUST_AGENTS 設定的彙整狀態及其由此函式呼叫所設定的信任代理設定。 特別是：如果任何管理員設定 #KEYGUARD_DISABLE_TRUST_AGENTS 了但沒有額外設定任何信任代理設定，信任代理將完全被停用。 否則，信任代理會從所有管理員 #KEYGUARD_DISABLE_TRUST_AGENTS 那裡接收設定清單，管理員會將其設定並彙總以判斷其行為。 聚合的確切含義是信任代理人專屬的。

必須是呼叫裝置管理員申請 DeviceAdminInfo#USES_POLICY_DISABLE_KEYGUARD_FEATURES 才能呼叫此方法;否則會拋出安全例外。

此方法可在回傳#getParentProfileInstance(ComponentName)的實例上呼叫DevicePolicyManager，以設定父配置檔的設定。

對於不支援 PackageManager#FEATURE_SECURE_LOCK_SCREEN 此功能的裝置，呼叫此方法不會產生影響——不會設定信任代理設定。

Java 文件 android.app.admin.DevicePolicyManager.setTrustAgentConfiguration(android.content.ComponentName, android.content.ComponentName, android.os.PersistableBundle)。

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

適用於