Sprache

DevicePolicyManager.RetrieveNetworkLogs(ComponentName, Int64) Methode

Definition

Aufgerufen vom Gerätebesitzer, Profilbesitzer eines verwalteten Profils oder delegierter App zum #DELEGATION_NETWORK_LOGGING Abrufen des neuesten Batches von Netzwerkprotokollierungsereignissen.

[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>

Parameter

admin
ComponentName

Dieser DeviceAdminReceiver Anforderung ist zugeordnet oder null wird von einer delegierten App aufgerufen.

batchToken
Int64

Ein Token des abzurufenden Batches

Gibt zurück

Ein neuer Batch von Netzwerkprotokollen, die eine Liste von NetworkEvent. Gibt zurück null , wenn der durch batchToken dargestellte Batch nicht mehr verfügbar ist oder die Protokollierung deaktiviert ist.

Attribute

Hinweise

Aufgerufen vom Gerätebesitzer, Profilbesitzer eines verwalteten Profils oder delegierter App zum #DELEGATION_NETWORK_LOGGING Abrufen des neuesten Batches von Netzwerkprotokollierungsereignissen.

Wenn die Netzwerkprotokollierung von einem Profilbesitzer aktiviert wird, umfassen die Netzwerkprotokolle nur Arbeitsprofil-Netzwerkaktivitäten, nicht Aktivitäten im persönlichen Profil.

Ein Gerätebesitzer oder Profilbesitzer muss ein batchToken bereitstellen, das als Teil des DeviceAdminReceiver#onNetworkLogsAvailable Rückrufs bereitgestellt wird. Wenn das Token nicht mit dem Token des neuesten verfügbaren Batches von Protokollen übereinstimmt, null wird dieses zurückgegeben.

NetworkEvent kann eine von DnsEvent oder ConnectEvent.

Die Liste der Netzwerkereignisse wird chronologisch sortiert und enthält höchstens 1200 Ereignisse.

Der Zugriff auf die Protokolle ist eingeschränkt, und diese Methode gibt nur einen neuen Batch von Protokollen zurück, nachdem der Gerätebesitzer per DeviceAdminReceiver#onNetworkLogsAvailableBenachrichtigung benachrichtigt wurde.

Wenn der Aufrufer kein Profilbesitzer ist und ein sekundärer Benutzer oder ein sekundäres Profil erstellt wird, löst das Aufrufen dieser Methode ein, SecurityException bis alle Benutzer wieder verbunden werden. Es ist auch nicht mehr möglich, den Netzwerkprotokollbatch mit dem zuletzt bereitgestellten batchToken abzurufen DeviceAdminReceiver#onNetworkLogsAvailable. Siehe DevicePolicyManager#setAffiliationIds.

Java Dokumentation für android.app.admin.DevicePolicyManager.retrieveNetworkLogs(android.content.ComponentName, long).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: