语言

DevicePolicyManager.SetNetworkLoggingEnabled(ComponentName, Boolean) 方法

定义

由设备所有者、托管配置文件或委托应用的配置文件所有者调用 #DELEGATION_NETWORK_LOGGING ,以控制网络日志记录功能。

[Android.Runtime.Register("setNetworkLoggingEnabled", "(Landroid/content/ComponentName;Z)V", "GetSetNetworkLoggingEnabled_Landroid_content_ComponentName_ZHandler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_NETWORK_LOGGING")]
public virtual void SetNetworkLoggingEnabled(Android.Content.ComponentName? admin, bool enabled);
[<Android.Runtime.Register("setNetworkLoggingEnabled", "(Landroid/content/ComponentName;Z)V", "GetSetNetworkLoggingEnabled_Landroid_content_ComponentName_ZHandler", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_NETWORK_LOGGING")>]
abstract member SetNetworkLoggingEnabled : Android.Content.ComponentName * bool -> unit
override this.SetNetworkLoggingEnabled : Android.Content.ComponentName * bool -> unit

参数

admin
ComponentName

DeviceAdminReceiver此请求与此请求相关联,或者null由委托的应用调用。

enabled
Boolean

是否应启用网络日志记录。

特性

注解

由设备所有者、托管配置文件或委托应用的配置文件所有者调用 #DELEGATION_NETWORK_LOGGING ,以控制网络日志记录功能。

支持来自 Android 8 的设备所有者和 Android 10 设备所有者授予的委托应用。 受托管配置文件的配置文件所有者和 Android 12 配置文件所有者授予的委托应用的支持。 当配置文件所有者启用网络日志记录时,网络日志将仅包括工作配置文件网络活动,而不是个人配置文件上的活动。

网络日志包含 DNS 查找和连接() 库调用事件。 网络日志记录处于活动状态时记录以下库函数:<ul><ligetaddrinfo()<>/li>>gethostbyname()<</li/liconnect()<<>>/li></ul>

网络日志记录是取证的低开销工具,但不能保证使用完整的系统调用日志记录;默认情况下,为所有进程启用事件报告,但不强行强制实施。 使用 libc 的替代实现、进行直接内核调用或故意模糊处理流量的应用程序的事件可能不会记录。

可能不会报告一些常见的网络事件。 例如: <ul><li>应用程序可以硬编码 IP 地址以减少 DNS 查找数,或使用替代系统进行名称解析,因此避免调用 getaddrinfo() 或 gethostbyname。</li><li>应用程序可能会出于性能原因(例如游戏客户端)使用数据报套接字。 此类套接字不需要调用 connect() ,因此不会触发网络事件。</li></ul>

可以直接截获第 3 层流量,从而使用始终启用 VPN 服务离开设备。 有关详细信息,请参阅 #setAlwaysOnVpnPackage(ComponentName, String, boolean) 和 android.net.VpnService 了解详细信息。

<strong Note:</strong>>:如果设备上没有关联辅助用户或配置文件,则设备所有者将无法检索网络日志,而不考虑是否启用该功能。 如果内部缓冲区在等待所有用户成为关联用户时填满,则会丢弃日志。 因此,建议在预配后 #setAffiliationIds尽快为新用户设置附属 ID。

Java文档android.app.admin.DevicePolicyManager.setNetworkLoggingEnabled(android.content.ComponentName, boolean)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于