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 。 呼び出し元がデバイス管理者でない場合は Null

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ドキュメント。

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

適用対象