Langue

DevicePolicyManager.RetrieveNetworkLogs(ComponentName, Int64) Méthode

Définition

Appelé par le propriétaire de l’appareil, le propriétaire de profil d’un profil managé ou une application déléguée avec #DELEGATION_NETWORK_LOGGING pour récupérer le lot le plus récent d’événements de journalisation réseau.

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

Paramètres

admin
ComponentName

Auquel DeviceAdminReceiver cette requête est associée, ou null si elle est appelée par une application déléguée.

batchToken
Int64

Jeton du lot à récupérer

Retours

Un nouveau lot de journaux réseau qui est une liste de NetworkEvent. Retourne null si le lot représenté par batchToken n’est plus disponible ou si la journalisation est désactivée.

Attributs

Remarques

Appelé par le propriétaire de l’appareil, le propriétaire de profil d’un profil managé ou une application déléguée avec #DELEGATION_NETWORK_LOGGING pour récupérer le lot le plus récent d’événements de journalisation réseau.

Lorsque la journalisation réseau est activée par un propriétaire de profil, les journaux réseau incluent uniquement l’activité réseau de profil professionnel, et non l’activité sur le profil personnel.

Un propriétaire d’appareil ou un propriétaire de profil doit fournir un batchToken fourni dans le cadre du DeviceAdminReceiver#onNetworkLogsAvailable rappel. Si le jeton ne correspond pas au jeton du lot de journaux disponible le plus récent, null il est retourné.

NetworkEvent peut être l’un des DnsEvent ou ConnectEvent.

La liste des événements réseau est triée chronologiquement et contient au maximum 1200 événements.

L’accès aux journaux est limité et cette méthode retourne uniquement un nouveau lot de journaux une fois que le propriétaire de l’appareil a été averti via DeviceAdminReceiver#onNetworkLogsAvailable.

Si l’appelant n’est pas un propriétaire de profil et qu’un utilisateur ou profil secondaire est créé, l’appel de cette méthode lève une SecurityException nouvelle fois jusqu’à ce que tous les utilisateurs soient de nouveau affiliés. Il n’est plus possible de récupérer le lot de journaux réseau avec le lot batchToken le plus récent fourni par DeviceAdminReceiver#onNetworkLogsAvailable. Voir DevicePolicyManager#setAffiliationIds.

Java documentation pour android.app.admin.DevicePolicyManager.retrieveNetworkLogs(android.content.ComponentName, long).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à