DevicePolicyManager.RetrieveNetworkLogs(ComponentName, Int64) メソッド

定義

名前空間:: Android.App.Admin

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ネットワークログイベントの最新のバッチを取得するために、デバイス所有者、マネージドプロファイルのプロファイル所有者、または #DELEGATION_NETWORK_LOGGING を使用して委任されたアプリによって呼び出されます。

[Android.Runtime.Register("retrieveNetworkLogs", "(Landroid/content/ComponentName;J)Ljava/util/List;", "GetRetrieveNetworkLogs_Landroid_content_ComponentName_JHandler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_NETWORK_LOGGING")]
public virtual System.Collections.Generic.IList<Android.App.Admin.NetworkEvent>? RetrieveNetworkLogs(Android.Content.ComponentName? admin, long batchToken);

[<Android.Runtime.Register("retrieveNetworkLogs", "(Landroid/content/ComponentName;J)Ljava/util/List;", "GetRetrieveNetworkLogs_Landroid_content_ComponentName_JHandler", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_NETWORK_LOGGING")>]
abstract member RetrieveNetworkLogs : Android.Content.ComponentName * int64 -> System.Collections.Generic.IList<Android.App.Admin.NetworkEvent>
override this.RetrieveNetworkLogs : Android.Content.ComponentName * int64 -> System.Collections.Generic.IList<Android.App.Admin.NetworkEvent>

パラメーター

admin: ComponentName

この要求が関連付けられている DeviceAdminReceiver 。委任されたアプリによって呼び出された場合は null 。

batchToken: Int64

取得するバッチのトークン

返品

IList<NetworkEvent>

NetworkEventの一覧であるネットワークログの新しいバッチ。 batchToken で表されるバッチが使用できなくなった場合、またはログ記録が無効になっている場合に null を返します。

属性: RegisterAttribute RequiresPermissionAttribute

注釈

プロファイル所有者がネットワークログを有効にすると、ネットワークログには、個人プロファイルのアクティビティではなく、仕事用プロファイルのネットワークアクティビティのみが含まれます。

デバイス所有者またはプロファイル所有者は、コールバックの一部として提供される batchToken DeviceAdminReceiver#onNetworkLogsAvailable 提供する必要があります。トークンがログの最新の使用可能なバッチのトークンと一致しない場合は、 null が返されます。

NetworkEvent には、 DnsEvent または ConnectEventのいずれかを指定できます。

ネットワークイベントの一覧は時系列で並べ替えられます。最大で 1,200 個のイベントが含まれます。

ログへのアクセスはレート制限されており、この方法では、デバイスデバイス所有者に DeviceAdminReceiver#onNetworkLogsAvailable経由で通知された後にのみ、ログの新しいバッチが返されます。

呼び出し元がプロファイル所有者ではなく、セカンダリユーザーまたはプロファイルが作成された場合、このメソッドを呼び出すと、すべてのユーザーが再び関連付けされるまで SecurityException がスローされます。また、 DeviceAdminReceiver#onNetworkLogsAvailableによって提供された最新の batchToken を使用して、ネットワークログバッチを取得することもできなくなります。 DevicePolicyManager#setAffiliationIdsを参照してください。

Javaドキュメント。

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

適用対象