DevicePolicyManager.RetrieveNetworkLogs(ComponentName, Int64) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
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.