1# net_connection.h 2 3## 概述 4 5为网络管理数据网络连接模块提供C接口。 6 7**引用文件：** <network/netmanager/net_connection.h> 8 9**库：** libnet_connection.so 10 11**系统能力：** SystemCapability.Communication.NetManager.Core 12 13**起始版本：** 11 14 15**相关模块：** [NetConnection](capi-netconnection.md) 16 17## 汇总 18 19### 函数 20 21| 名称 | 描述 | 22| -- | -- | 23| [int32_t OH_NetConn_HasDefaultNet(int32_t *hasDefaultNet)](#oh_netconn_hasdefaultnet) | 查询是否有默认激活的数据网络。 | 24| [int32_t OH_NetConn_GetDefaultNet(NetConn_NetHandle *netHandle)](#oh_netconn_getdefaultnet) | 获取激活的默认的数据网络。 | 25| [int32_t OH_NetConn_IsDefaultNetMetered(int32_t *isMetered)](#oh_netconn_isdefaultnetmetered) | 查询默认网络是否按流量计费。 | 26| [int32_t OH_NetConn_GetConnectionProperties(NetConn_NetHandle *netHandle, NetConn_ConnectionProperties *prop)](#oh_netconn_getconnectionproperties) | 查询某个数据网络的链路信息。 | 27| [int32_t OH_NetConn_GetNetCapabilities(NetConn_NetHandle *netHandle, NetConn_NetCapabilities *netCapabilities)](#oh_netconn_getnetcapabilities) | 查询某个网络的能力集。 | 28| [int32_t OH_NetConn_GetDefaultHttpProxy(NetConn_HttpProxy *httpProxy)](#oh_netconn_getdefaulthttpproxy) | 查询默认的网络代理。 | 29| [int32_t OH_NetConn_GetAddrInfo(char *host, char *serv, struct addrinfo *hint, struct addrinfo **res, int32_t netId)](#oh_netconn_getaddrinfo) | 通过netId获取DNS结果。 | 30| [int32_t OH_NetConn_FreeDnsResult(struct addrinfo *res)](#oh_netconn_freednsresult) | 释放DNS结果。 | 31| [int32_t OH_NetConn_GetAllNets(NetConn_NetHandleList *netHandleList)](#oh_netconn_getallnets) | 查询所有激活的数据网络。 | 32| [int32_t OHOS_NetConn_RegisterDnsResolver(OH_NetConn_CustomDnsResolver resolver)](#ohos_netconn_registerdnsresolver) | 注册自定义DNS解析器。 | 33| [int32_t OHOS_NetConn_UnregisterDnsResolver(void)](#ohos_netconn_unregisterdnsresolver) | 取消注册自定义DNS解析器。 | 34| [int32_t OH_NetConn_RegisterDnsResolver(OH_NetConn_CustomDnsResolver resolver)](#oh_netconn_registerdnsresolver) | 注册自定义DNS解析器。 | 35| [int32_t OH_NetConn_UnregisterDnsResolver(void)](#oh_netconn_unregisterdnsresolver) | 取消注册自定义DNS解析器。 | 36| [int32_t OH_NetConn_BindSocket(int32_t socketFd, NetConn_NetHandle *netHandle)](#oh_netconn_bindsocket) | 将套接字绑定到特定的网络。 | 37| [int32_t OH_NetConn_SetAppHttpProxy(NetConn_HttpProxy *httpProxy)](#oh_netconn_setapphttpproxy) | 为当前应用设置http代理配置信息。 | 38| [int32_t OH_NetConn_RegisterAppHttpProxyCallback(OH_NetConn_AppHttpProxyChange appHttpProxyChange, uint32_t *callbackId)](#oh_netconn_registerapphttpproxycallback) | 注册监听应用http代理变化的回调。 | 39| [void OH_NetConn_UnregisterAppHttpProxyCallback(uint32_t callbackId)](#oh_netconn_unregisterapphttpproxycallback) | 注销监听应用http代理变化的回调。 | 40| [int32_t OH_NetConn_RegisterNetConnCallback(NetConn_NetSpecifier *specifier, NetConn_NetConnCallback *netConnCallback,uint32_t timeout, uint32_t *callbackId)](#oh_netconn_registernetconncallback) | 注册监听网络状态变化的回调。 | 41| [int32_t OH_NetConn_RegisterDefaultNetConnCallback(NetConn_NetConnCallback *netConnCallback, uint32_t *callbackId)](#oh_netconn_registerdefaultnetconncallback) | 注册监听默认网络状态变化的回调。 | 42| [int32_t OH_NetConn_UnregisterNetConnCallback(uint32_t callBackId)](#oh_netconn_unregisternetconncallback) | 注销监听网络状态变化的回调。 | 43| [NetConn_ErrorCode OH_NetConn_SetPacUrl(const char *pacUrl)](#oh_netconn_setpacurl) | 设置系统级代理自动配置（PAC）脚本地址。 | 44| [NetConn_ErrorCode OH_NetConn_GetPacUrl(char *pacUrl)](#oh_netconn_getpacurl) | 获取系统级代理自动配置（PAC）脚本地址。 | 45| [int32_t OH_NetConn_QueryProbeResult(char *destination, int32_t duration, NetConn_ProbeResultInfo *probeResultInfo)](#oh_netconn_queryproberesult) | 查询网络探测结果。 | 46| [int32_t OH_NetConn_QueryTraceRoute(char *destination, NetConn_TraceRouteOption *option,NetConn_TraceRouteInfo *traceRouteInfo)](#oh_netconn_querytraceroute) | 查询网络跟踪路由。 | 47 48 49## 函数说明 50 51### OH_NetConn_HasDefaultNet() 52 53``` 54int32_t OH_NetConn_HasDefaultNet(int32_t *hasDefaultNet) 55``` 56 57**描述** 58 59查询是否有默认激活的数据网络。 60 61**系统能力：** SystemCapability.Communication.NetManager.Core 62 63**需要权限：** ohos.permission.GET_NETWORK_INFO 64 65**起始版本：** 11 66 67 68**参数：** 69 70| 参数项 | 描述 | 71| -- | -- | 72| int32_t *hasDefaultNet | 是否有默认网络。 | 73 74**返回：** 75 76| 类型 | 说明 | 77| -- | -- | 78| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 79 80### OH_NetConn_GetDefaultNet() 81 82``` 83int32_t OH_NetConn_GetDefaultNet(NetConn_NetHandle *netHandle) 84``` 85 86**描述** 87 88获取激活的默认的数据网络。 89 90**系统能力：** SystemCapability.Communication.NetManager.Core 91 92**需要权限：** ohos.permission.GET_NETWORK_INFO 93 94**起始版本：** 11 95 96 97**参数：** 98 99| 参数项 | 描述 | 100| -- | -- | 101| [NetConn_NetHandle](capi-netconnection-netconn-nethandle.md) *netHandle | 存放网络ID。 | 102 103**返回：** 104 105| 类型 | 说明 | 106| -- | -- | 107| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 108 109### OH_NetConn_IsDefaultNetMetered() 110 111``` 112int32_t OH_NetConn_IsDefaultNetMetered(int32_t *isMetered) 113``` 114 115**描述** 116 117查询默认数据网络是否记流量。 118 119**系统能力：** SystemCapability.Communication.NetManager.Core 120 121**需要权限：** ohos.permission.GET_NETWORK_INFO 122 123**起始版本：** 11 124 125 126**参数：** 127 128| 参数项 | 描述 | 129| -- | -- | 130| int32_t *isMetered | 是否激活。 | 131 132**返回：** 133 134| 类型 | 说明 | 135| -- | -- | 136| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 137 138### OH_NetConn_GetConnectionProperties() 139 140``` 141int32_t OH_NetConn_GetConnectionProperties(NetConn_NetHandle *netHandle, NetConn_ConnectionProperties *prop) 142``` 143 144**描述** 145 146查询某个数据网络的链路信息。 147 148**系统能力：** SystemCapability.Communication.NetManager.Core 149 150**需要权限：** ohos.permission.GET_NETWORK_INFO 151 152**起始版本：** 11 153 154 155**参数：** 156 157| 参数项 | 描述 | 158| -- | -- | 159| [NetConn_NetHandle](capi-netconnection-netconn-nethandle.md) *netHandle | 存放网络ID。 | 160| [NetConn_ConnectionProperties](capi-netconnection-netconn-connectionproperties.md) *prop | 存放链路信息。 | 161 162**返回：** 163 164| 类型 | 说明 | 165| -- | -- | 166| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 167 168### OH_NetConn_GetNetCapabilities() 169 170``` 171int32_t OH_NetConn_GetNetCapabilities(NetConn_NetHandle *netHandle, NetConn_NetCapabilities *netCapabilities) 172``` 173 174**描述** 175 176查询某个网络的能力集。 177 178**系统能力：** SystemCapability.Communication.NetManager.Core 179 180**需要权限：** ohos.permission.GET_NETWORK_INFO 181 182**起始版本：** 11 183 184 185**参数：** 186 187| 参数项 | 描述 | 188|-------------------------------------------------------------------------| -- | 189| [NetConn_NetHandle](capi-netconnection-netconn-nethandle.md) *netHandle | 存放网络ID。 | 190| [NetConn_NetCapabilities](capi-netconnection-netconn-netcapabilities.md) *netCapabilities | 存放能力集。 | 191 192**返回：** 193 194| 类型 | 说明 | 195| -- | -- | 196| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误. 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 197 198### OH_NetConn_GetDefaultHttpProxy() 199 200``` 201int32_t OH_NetConn_GetDefaultHttpProxy(NetConn_HttpProxy *httpProxy) 202``` 203 204**描述** 205 206查询默认的网络代理。 207 208**系统能力：** SystemCapability.Communication.NetManager.Core 209 210**起始版本：** 11 211 212 213**参数：** 214 215| 参数项 | 描述 | 216| -- | -- | 217| [NetConn_HttpProxy](capi-netconnection-netconn-httpproxy.md) *httpProxy | 存放代理配置信息。 | 218 219**返回：** 220 221| 类型 | 说明 | 222| -- | -- | 223| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误. 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 224 225### OH_NetConn_GetAddrInfo() 226 227``` 228int32_t OH_NetConn_GetAddrInfo(char *host, char *serv, struct addrinfo *hint, struct addrinfo **res, int32_t netId) 229``` 230 231**描述** 232 233通过netId获取DNS结果。 234 235**系统能力：** SystemCapability.Communication.NetManager.Core 236 237**需要权限：** ohos.permission.INTERNET 238 239**起始版本：** 11 240 241 242**参数：** 243 244| 参数项 | 描述 | 245| -- | -- | 246| char *host | 所需查询的host名。 | 247| char *serv | 服务名。 | 248| struct addrinfo *hint | 指向addrinfo结构体的指针。 | 249| struct addrinfo **res | 存放DNS查询结果，以链表形式返回。 | 250| int32_t netId | DNS查询netId为0时，使用默认netid查询。 | 251 252**返回：** 253 254| 类型 | 说明 | 255| -- | -- | 256| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 257 258### OH_NetConn_FreeDnsResult() 259 260``` 261int32_t OH_NetConn_FreeDnsResult(struct addrinfo *res) 262``` 263 264**描述** 265 266释放DNS结果。 267 268**系统能力：** SystemCapability.Communication.NetManager.Core 269 270**需要权限：** ohos.permission.INTERNET 271 272**起始版本：** 11 273 274 275**参数：** 276 277| 参数项 | 描述 | 278| -- | -- | 279| struct addrinfo *res | DNS查询结果链表头。 | 280 281**返回：** 282 283| 类型 | 说明 | 284| -- | -- | 285| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 286 287### OH_NetConn_GetAllNets() 288 289``` 290int32_t OH_NetConn_GetAllNets(NetConn_NetHandleList *netHandleList) 291``` 292 293**描述** 294 295查询所有激活的数据网络。 296 297**系统能力：** SystemCapability.Communication.NetManager.Core 298 299**需要权限：** ohos.permission.GET_NETWORK_INFO 300 301**起始版本：** 11 302 303 304**参数：** 305 306| 参数项 | 描述 | 307| -- | -- | 308| [NetConn_NetHandleList](capi-netconnection-netconn-nethandlelist.md) *netHandleList | 网络信息列表。 | 309 310**返回：** 311 312| 类型 | 说明 | 313| -- | -- | 314| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 315 316### OHOS_NetConn_RegisterDnsResolver() 317 318``` 319int32_t OHOS_NetConn_RegisterDnsResolver(OH_NetConn_CustomDnsResolver resolver) 320``` 321 322**描述** 323 324注册自定义DNS解析器。 325 326**系统能力：** SystemCapability.Communication.NetManager.Core 327 328**需要权限：** ohos.permission.INTERNET 329 330**起始版本：** 11 331 332**废弃版本：** 13 333 334**替代接口：** OH_NetConn_RegisterDnsResolver 335 336 337**参数：** 338 339| 参数项 | 描述 | 340| -- | -- | 341| [OH_NetConn_CustomDnsResolver](capi-net-connection-type-h.md#oh_netconn_customdnsresolver) resolver | 指向自定义DNS解析器的指针。 | 342 343**返回：** 344 345| 类型 | 说明 | 346| -- | -- | 347| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 348 349### OHOS_NetConn_UnregisterDnsResolver() 350 351``` 352int32_t OHOS_NetConn_UnregisterDnsResolver(void) 353``` 354 355**描述** 356 357取消注册自定义DNS解析器。 358 359**系统能力：** SystemCapability.Communication.NetManager.Core 360 361**需要权限：** ohos.permission.INTERNET 362 363**起始版本：** 11 364 365**废弃版本：** 13 366 367**替代接口：** OH_NetConn_UnregisterDnsResolver 368 369**返回：** 370 371| 类型 | 说明 | 372| -- | -- | 373| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 374 375### OH_NetConn_RegisterDnsResolver() 376 377``` 378int32_t OH_NetConn_RegisterDnsResolver(OH_NetConn_CustomDnsResolver resolver) 379``` 380 381**描述** 382 383注册自定义DNS解析器。 384 385**系统能力：** SystemCapability.Communication.NetManager.Core 386 387**需要权限：** ohos.permission.INTERNET 388 389**起始版本：** 13 390 391 392**参数：** 393 394| 参数项 | 描述 | 395| -- | -- | 396| 指向自定义DNS解析器的指针。 | | 397 398**返回：** 399 400| 类型 | 说明 | 401| -- | -- | 402| int32_t | 返回结果码。<br> NETMANAGER_EXT_SUCCESS 如果操作成功。<br> NETMANAGER_ERR_PERMISSION_DENIED 缺少权限，请添加权限。<br> NETMANAGER_ERR_PARAMETER_ERROR 参数错误。请输入正确的参数。 | 403 404### OH_NetConn_UnregisterDnsResolver() 405 406``` 407int32_t OH_NetConn_UnregisterDnsResolver(void) 408``` 409 410**描述** 411 412取消注册自定义DNS解析器。 413 414**系统能力：** SystemCapability.Communication.NetManager.Core 415 416**需要权限：** ohos.permission.INTERNET 417 418**起始版本：** 13 419 420**返回：** 421 422| 类型 | 说明 | 423| -- | -- | 424| int32_t | 0 - 成功。 201 - 缺少权限。<br> 401 - 参数错误。 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 425 426### OH_NetConn_BindSocket() 427 428``` 429int32_t OH_NetConn_BindSocket(int32_t socketFd, NetConn_NetHandle *netHandle) 430``` 431 432**描述** 433 434将套接字绑定到特定的网络。 435 436**系统能力：** SystemCapability.Communication.NetManager.Core 437 438**起始版本：** 12 439 440 441**参数：** 442 443| 参数项 | 描述 | 444| -- | -- | 445| int32_t socketFd | 由用户构造的套接字。 | 446| [NetConn_NetHandle](capi-netconnection-netconn-nethandle.md) *netHandle | 指针类型，指向包含网络ID的网络句柄。 | 447 448**返回：** 449 450| 类型 | 说明 | 451| -- | -- | 452| int32_t | 0 - 成功。<br> 401 - 参数错误。<br> 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。 | 453 454### OH_NetConn_SetAppHttpProxy() 455 456``` 457int32_t OH_NetConn_SetAppHttpProxy(NetConn_HttpProxy *httpProxy) 458``` 459 460**描述** 461 462为当前应用设置http代理配置信息。 463 464**系统能力：** SystemCapability.Communication.NetManager.Core 465 466**起始版本：** 12 467 468 469**参数：** 470 471| 参数项 | 描述 | 472| -- | -- | 473| [NetConn_HttpProxy](capi-netconnection-netconn-httpproxy.md) *httpProxy | 需要设置的http代理配置信息。 | 474 475**返回：** 476 477| 类型 | 说明 | 478| -- | -- | 479| int32_t | 0 - 成功。<br> 401 - 参数错误。 | 480 481### OH_NetConn_RegisterAppHttpProxyCallback() 482 483``` 484int32_t OH_NetConn_RegisterAppHttpProxyCallback(OH_NetConn_AppHttpProxyChange appHttpProxyChange, uint32_t *callbackId) 485``` 486 487**描述** 488 489注册监听应用http代理变化的回调。 490 491**系统能力：** SystemCapability.Communication.NetManager.Core 492 493**起始版本：** 12 494 495 496**参数：** 497 498| 参数项 | 描述 | 499| -- | -- | 500| [OH_NetConn_AppHttpProxyChange](capi-net-connection-type-h.md#oh_netconn_apphttpproxychange) appHttpProxyChange | 需要注册的监听回调。 | 501| uint32_t *callbackId | 回调注册后生成的id, 关联已注册的回调。 | 502 503**返回：** 504 505| 类型 | 说明 | 506| -- | -- | 507| int32_t | 0 - 成功。<br> 401 - 参数错误。 | 508 509### OH_NetConn_UnregisterAppHttpProxyCallback() 510 511``` 512void OH_NetConn_UnregisterAppHttpProxyCallback(uint32_t callbackId) 513``` 514 515**描述** 516 517注销监听应用http代理变化的回调。 518 519**系统能力：** SystemCapability.Communication.NetManager.Core 520 521**起始版本：** 12 522 523 524**参数：** 525 526| 参数项 | 描述 | 527| -- | -- | 528| uint32_t callbackId | 需要被注销的回调所对应的id。 | 529 530### OH_NetConn_RegisterNetConnCallback() 531 532``` 533int32_t OH_NetConn_RegisterNetConnCallback(NetConn_NetSpecifier *specifier, NetConn_NetConnCallback *netConnCallback,uint32_t timeout, uint32_t *callbackId) 534``` 535 536**描述** 537 538注册监听网络状态变化的回调。 539 540**系统能力：** SystemCapability.Communication.NetManager.Core 541 542**需要权限：** ohos.permission.GET_NETWORK_INFO 543 544**起始版本：** 12 545 546 547**参数：** 548 549| 参数项 | 描述 | 550| -- | -- | 551| netSpecifier | 网络特征集。 | 552| callback | 注册的回调函数集合。 | 553| uint32_t timeout | 超时时间，单位为毫秒，为0时表示无限等待。 | 554| uint32_t *callbackId | 出参，对应本次注册成功的回调。 | 555 556**返回：** 557 558| 类型 | 说明 | 559| -- | -- | 560| int32_t | 0 - 成功。<br> 201 - 缺少权限。<br> 401 - 参数错误。<br> 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。<br> 2101008 - 回调已注册。<br> 2101022 - 请求数超出了允许的最大值。 | 561 562### OH_NetConn_RegisterDefaultNetConnCallback() 563 564``` 565int32_t OH_NetConn_RegisterDefaultNetConnCallback(NetConn_NetConnCallback *netConnCallback, uint32_t *callbackId) 566``` 567 568**描述** 569 570注册监听默认网络状态变化的回调。 571 572**系统能力：** SystemCapability.Communication.NetManager.Core 573 574**需要权限：** ohos.permission.GET_NETWORK_INFO 575 576**起始版本：** 12 577 578 579**参数：** 580 581| 参数项 | 描述 | 582| -- | -- | 583| callback | 注册的回调函数集合。 | 584| uint32_t *callbackId | 出参，对应本次注册成功的回调。 | 585 586**返回：** 587 588| 类型 | 说明 | 589| -- | -- | 590| int32_t | 0 - 成功。<br> 201 - 缺少权限。<br> 401 - 参数错误。<br> 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。<br> 2101008 - 回调已注册。<br> 2101022 - 请求数超出了允许的最大值。 | 591 592### OH_NetConn_UnregisterNetConnCallback() 593 594``` 595int32_t OH_NetConn_UnregisterNetConnCallback(uint32_t callBackId) 596``` 597 598**描述** 599 600注销监听网络状态变化的回调。 601 602**系统能力：** SystemCapability.Communication.NetManager.Core 603 604**需要权限：** ohos.permission.GET_NETWORK_INFO 605 606**起始版本：** 12 607 608 609**参数：** 610 611| 参数项 | 描述 | 612| -- | -- | 613| uint32_t callBackId | 需要被注销的回调对应id。 | 614 615**返回：** 616 617| 类型 | 说明 | 618| -- | -- | 619| int32_t | 0 - 成功。<br> 201 - 缺少权限。<br> 401 - 参数错误。<br> 2100002 - 无法连接到服务。<br> 2100003 - 内部错误。<br> 2101007 - 回调不存在。 | 620 621### OH_NetConn_SetPacUrl() 622 623``` 624NetConn_ErrorCode OH_NetConn_SetPacUrl(const char *pacUrl) 625``` 626 627**描述** 628 629设置系统级代理自动配置（PAC）脚本地址。 630 631**需要权限：** ohos.permission.SET_PAC_URL 632 633**起始版本：** 15 634 635 636**参数：** 637 638| 参数项 | 描述 | 639| -- | -- | 640| const char *pacUrl | 需要设置的PAC脚本地址。 | 641 642**返回：** 643 644| 类型 | 说明 | 645| -- | -- | 646| [NetConn_ErrorCode](capi-net-connection-type-h.md#netconn_errorcode) | 结果定义在 [NetConn_ErrorCode](capi-net-connection-type-h.md#netconn_errorcode)。<br> [NETCONN_SUCCESS](capi-net-connection-type-h.md#netconn_errorcode) 成功。<br> [NETCONN_PERMISSION_DENIED](capi-net-connection-type-h.md#netconn_errorcode) 缺少权限。<br> [NETCONN_PARAMETER_ERROR](capi-net-connection-type-h.md#netconn_errorcode) 参数错误。<br> [NETCONN_OPERATION_FAILED](capi-net-connection-type-h.md#netconn_errorcode) 无法连接到服务。<br> [NETCONN_INTERNAL_ERROR](capi-net-connection-type-h.md#netconn_errorcode) 内部错误。 | 647 648### OH_NetConn_GetPacUrl() 649 650``` 651NetConn_ErrorCode OH_NetConn_GetPacUrl(char *pacUrl) 652``` 653 654**描述** 655 656获取系统级代理自动配置（PAC）脚本地址。 657 658**起始版本：** 15 659 660 661**参数：** 662 663| 参数项 | 描述 | 664| -- | -- | 665| char *pacUrl | 获取的PAC脚本地址。 | 666 667**返回：** 668 669| 类型 | 说明 | 670| -- | -- | 671| [NetConn_ErrorCode](capi-net-connection-type-h.md#netconn_errorcode) | 结果定义在 [NetConn_ErrorCode](capi-net-connection-type-h.md#netconn_errorcode)。<br> [NETCONN_SUCCESS](capi-net-connection-type-h.md#netconn_errorcode) 成功。<br> [NETCONN_PARAMETER_ERROR](capi-net-connection-type-h.md#netconn_errorcode) 参数错误。<br> [NETCONN_OPERATION_FAILED](capi-net-connection-type-h.md#netconn_errorcode) 无法连接到服务。<br> [NETCONN_INTERNAL_ERROR](capi-net-connection-type-h.md#netconn_errorcode) 内部错误。 | 672 673### OH_NetConn_QueryProbeResult() 674 675``` 676int32_t OH_NetConn_QueryProbeResult(char *destination, int32_t duration, NetConn_ProbeResultInfo *probeResultInfo) 677``` 678 679**描述** 680 681查询网络探测结果。 682 683**需要权限：** ohos.permission.INTERNET 684 685**起始版本：** 20 686 687 688**参数：** 689 690| 参数项 | 描述 | 691| -- | -- | 692| char *destination | 目的地址。 | 693| int32_t duration | 探测持续时间。单位：秒。 | 694| [NetConn_ProbeResultInfo](capi-netconnection-netconn-proberesultinfo.md) *probeResultInfo | 丢包率和往返时间（RTT）。 | 695 696**返回：** 697 698| 类型 | 说明 | 699| -- | -- | 700| int32_t | 0 - 成功。<br> 201 - 缺少权限。<br> 401 - 参数错误。<br> 2100003 - 内部错误。 | 701 702### OH_NetConn_QueryTraceRoute() 703 704``` 705int32_t OH_NetConn_QueryTraceRoute(char *destination, NetConn_TraceRouteOption *option,NetConn_TraceRouteInfo *traceRouteInfo) 706``` 707 708**描述** 709 710查询网络跟踪路由。 711 712**需要权限：** ohos.permission.INTERNET、ohos.permission.LOCATION 和 ohos.permission.ACCESS_NET_TRACE_INFO 713 714**起始版本：** 20 715 716 717**参数：** 718 719| 参数项 | 描述 | 720| -- | -- | 721| char *destination | 目的地址。 | 722| [NetConn_TraceRouteOption](capi-netconnection-netconn-tracerouteoption.md) *option | 路由参数选项。 | 723| [NetConn_TraceRouteInfo](capi-netconnection-netconn-tracerouteinfo.md) *traceRouteInfo | 路由结果。需传入数组指针，数组大小代表路由跳数，默认30跳。 | 724 725**返回：** 726 727| 类型 | 说明 | 728| -- | -- | 729| int32_t | 0 - 成功。<br> 201 - 缺少权限。 | 730