語言

DevicePolicyManager.RetrieveNetworkLogs(ComponentName, Int64) 方法

定義

由裝置擁有者、管理設定檔的設定檔擁有者或委託應用程式 #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

批次的標記,要取回

傳回

一組新的網路日誌,包含 NetworkEvent。 如果 batchToken 所代表的批次不再可用或日誌被停用,則會回傳 null 。

屬性

備註

由裝置擁有者、管理設定檔的設定檔擁有者或委託應用程式 #DELEGATION_NETWORK_LOGGING 呼叫,以取得最新的網路日誌事件批次。

當網路日誌由設定檔擁有者啟用時,網路日誌只會包含工作設定檔的網路活動,而不會包含個人設定檔的活動。

裝置擁有者或設定檔擁有者必須提供作為回撥一部分 DeviceAdminReceiver#onNetworkLogsAvailable 的批次令牌。 若該令牌與最近一批可用日誌的令牌不符, null 則會被回傳。

NetworkEvent 可以是其中 DnsEvent 之一或 ConnectEvent。

網路事件列表按時間順序排列,最多包含1200個事件。

日誌存取速率有限,且此方法僅在裝置擁有者收到通知 DeviceAdminReceiver#onNetworkLogsAvailable後,才會回傳新的日誌批次。

若來電者非個人檔案擁有者且建立了次要使用者或個人檔案,此方法會拋棄 a SecurityException ,直到所有用戶重新成為聯盟。 也將無法再用最新的 batchToken DeviceAdminReceiver#onNetworkLogsAvailable來取得網路日誌批次。 參見 DevicePolicyManager#setAffiliationIds。

Java 文件 android.app.admin.DevicePolicyManager.retrieveNetworkLogs(android.content.ComponentName, long)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於