1# NetConnection 2 3 4## 概述 5 6为网络管理数据网络连接模块提供C接口。 7 8**起始版本：** 11 9 10 11## 汇总 12 13 14### 文件 15 16| 名称 | 描述 | 17| -------- | -------- | 18| [net_connection.h](net__connection_8h.md) | 为网络管理数据网络连接模块提供C接口。<br>**引用文件：** \<network\/netmanager\/net_connection.h\> | 19| [net_connection_type.h](net__connection__type_8h.md) | 定义网络连接模块的C接口需要的数据结构。<br>**引用文件：** \<network\/netmanager\/net_connection_type.h\> | 20 21 22### 结构体 23 24| 名称 | 描述 | 25| -------- | -------- | 26| [NetConn_NetHandle](_net_conn___net_handle.md) | 存放网络ID。 | 27| [NetConn_NetCapabilities](_net_conn___net_capabilities.md) | 网络能力集。 | 28| [NetConn_NetAddr](_net_conn___net_addr.md) | 网络地址。 | 29| [NetConn_Route](_net_conn___route.md) | 路由配置信息。 | 30| [NetConn_HttpProxy](_net_conn___http_proxy.md) | 代理配置信息。 | 31| [NetConn_ConnectionProperties](_net_conn___connection_properties.md) | 网络链接信息。 | 32| [NetConn_NetHandleList](_net_conn___net_handle_list.md) | 网络列表。 | 33| [NetConn_NetConnCallback](_net_conn___net_conn_callback.md) | 网络状态监听回调集合。 | 34| [NetConn_NetSpecifier](_net_conn___net_specifier.md) | 网络的特征集，包含网络的能力集与网络的标识符。 | 35 36 37### 宏定义 38 39| 名称 | 描述 | 40| -------- | -------- | 41| **NETCONN_MAX_NET_SIZE** | 32 | 42| **NETCONN_MAX_BEARER_TYPE_SIZE** | 32 | 43| **NETCONN_MAX_CAP_SIZE** | 32 | 44| **NETCONN_MAX_ADDR_SIZE** | 32 | 45| **NETCONN_MAX_ROUTE_SIZE** | 64 | 46| **NETCONN_MAX_EXCLUSION_SIZE** | 256 | 47| **NETCONN_MAX_STR_LEN** | 256 | 48 49 50### 类型定义 51 52| 名称 | 描述 | 53| -------- | -------- | 54| [NetConn_NetCap](#netconn_netcap) | 网络能力集。 | 55| [NetConn_NetBearerType](#netconn_netbearertype) | 网络载体类型。 | 56| [NetConn_NetHandle](#netconn_nethandle) | 存放网络ID。 | 57| [NetConn_NetCapabilities](#netconn_netcapabilities) | 网络能力集。 | 58| [NetConn_NetAddr](#netconn_netaddr) | 网络地址。 | 59| [NetConn_Route](#netconn_route) | 路由配置信息。 | 60| [NetConn_HttpProxy](#netconn_httpproxy) | 代理配置信息。 | 61| [NetConn_ConnectionProperties](#netconn_connectionproperties) | 网络链接信息。 | 62| [NetConn_NetHandleList](#netconn_nethandlelist) | 网络列表。 | 63| (\*[OH_NetConn_CustomDnsResolver](#oh_netconn_customdnsresolver)) (const char \*host, const char \*serv, const struct addrinfo \*hint, struct addrinfo \*\*res) | 指向自定义 DNS 解析器的指针。 | 64| [NetConn_NetConnCallback](#netconn_netconncallback) | 网络状态监听回调集合。 | 65| [NetConn_NetSpecifier](#netconn_netspecifier) | 网络的特征集，包含网络的能力集与网络的标识符。 | 66 67### 枚举 68 69| 名称 | 描述 | 70| -------- | -------- | 71| [NetConn_NetCap](#netconn_netcap) {<br/>NETCONN_NET_CAPABILITY_MMS = 0,<br/>NETCONN_NET_CAPABILITY_NOT_METERED = 11,<br/>NETCONN_NET_CAPABILITY_INTERNET = 12,<br/>NETCONN_NET_CAPABILITY_NOT_VPN = 15,<br/>NETCONN_NET_CAPABILITY_VALIDATED = 16<br/>} | 网络能力集。 | 72| [NetConn_NetBearerType](#netconn_netbearertype) {<br/>NETCONN_BEARER_CELLULAR = 0,<br/>NETCONN_BEARER_WIFI = 1,<br/>NETCONN_BEARER_ETHERNET = 3<br/>NETCONN_BEARER_VPN = 4<br/>} | 网络载体类型。 | 73 74 75### 函数 76 77| 名称 | 描述 | 78| -------- | -------- | 79| [OH_NetConn_HasDefaultNet](#oh_netconn_hasdefaultnet) (int32_t \*hasDefaultNet) | 查询是否有默认激活的数据网络。 | 80| [OH_NetConn_GetDefaultNet](#oh_netconn_getdefaultnet) ([NetConn_NetHandle](_net_conn___net_handle.md) \*netHandle) | 获取激活的默认的数据网络。 | 81| [OH_NetConn_IsDefaultNetMetered](#oh_netconn_isdefaultnetmetered) (int32_t \*isMetered) | 查询默认网络是否按流量计费。 | 82| [OH_NetConn_GetConnectionProperties](#oh_netconn_getconnectionproperties) ([NetConn_NetHandle](_net_conn___net_handle.md) \*netHandle, [NetConn_ConnectionProperties](_net_conn___connection_properties.md) \*prop) | 查询某个数据网络的链路信息。 | 83| [OH_NetConn_GetNetCapabilities](#oh_netconn_getnetcapabilities) ([NetConn_NetHandle](_net_conn___net_handle.md) \*netHandle, [NetConn_NetCapabilities](_net_conn___net_capabilities.md) \*netCapacities) | 查询某个网络的能力集。 | 84| [OH_NetConn_GetDefaultHttpProxy](#oh_netconn_getdefaulthttpproxy) ([NetConn_HttpProxy](_net_conn___http_proxy.md) \*httpProxy) | 查询默认的网络代理。 | 85| [OH_NetConn_GetAddrInfo](#oh_netconn_getaddrinfo) (char \*host, char \*serv, struct addrinfo \*hint, struct addrinfo \*\*res, int32_t netId) | 通过netId获取DNS结果。 | 86| [OH_NetConn_FreeDnsResult](#oh_netconn_freednsresult) (struct addrinfo \*res) | 释放DNS结果。 | 87| [OH_NetConn_GetAllNets](#oh_netconn_getallnets) ([NetConn_NetHandleList](_net_conn___net_handle_list.md) \*netHandleList) | 查询所有激活的数据网络。 | 88| [OHOS_NetConn_RegisterDnsResolver](#ohos_netconn_registerdnsresolver-deprecated) ([OH_NetConn_CustomDnsResolver](#oh_netconn_customdnsresolver) resolver) | 注册自定义 DNS 解析器。 | 89| [OHOS_NetConn_UnregisterDnsResolver](#ohos_netconn_unregisterdnsresolver-deprecated) (void) | 取消注册自定义 DNS 解析器。 | 90| [OH_NetConn_RegisterDnsResolver](#oh_netconn_registerdnsresolver) ([OH_NetConn_CustomDnsResolver](#oh_netconn_customdnsresolver) resolver) | 注册自定义 DNS 解析器。 | 91| [OH_NetConn_UnregisterDnsResolver](#oh_netconn_unregisterdnsresolver) (void) | 取消注册自定义 DNS 解析器。 | 92| [OH_NetConn_BindSocket](#oh_netconn_bindsocket) (int32_t socketFd, [NetConn_NetHandle](_net_conn___net_handle.md) \*netHandle) | 将套接字与指定的网络进行绑定。 | 93| [OH_NetConn_SetAppHttpProxy](#oh_netconn_setapphttpproxy) ([NetConn_HttpProxy](_net_conn___http_proxy.md) \*httpProxy) | 设置应用级代理信息。 | 94| [OH_NetConn_RegisterAppHttpProxyCallback](#oh_netconn_registerapphttpproxycallback) ([OH_NetConn_AppHttpProxyChange](#oh_netconn_apphttpproxychange) appHttpProxyChange, uint32_t \*callbackId) | 注册监听应用级代理变化。 | 95| [OH_NetConn_UnregisterAppHttpProxyCallback](#oh_netconn_unregisterapphttpproxycallback) (uint32_t callbackId) | 注销监听应用级代理变化。 | 96| [OH_NetConn_RegisterNetConnCallback](#oh_netconn_registernetconncallback) ([NetConn_NetSpecifier](_net_conn___net_specifier.md) \*specifier, [NetConn_NetConnCallback](_net_conn___net_conn_callback.md) \*netConnCallback, uint32_t timeoutMS, uint32_t \*callbackId) | 注册监听网络状态的回调。 | 97| [OH_NetConn_RegisterDefaultNetConnCallback](#oh_netconn_registerdefaultnetconncallback) ([NetConn_NetConnCallback](_net_conn___net_conn_callback.md) \*netConnCallback, uint32_t \*callbackId) | 注册监听默认网络状态的回调。 | 98| [OH_NetConn_UnregisterNetConnCallback](#oh_netconn_unregisternetconncallback) (uint32_t callbackId) | 注销监听网络状态的回调。 | 99 100 101## 类型定义说明 102 103 104### NetConn_ConnectionProperties 105 106``` 107typedef struct NetConn_ConnectionProperties NetConn_ConnectionProperties 108``` 109 110**描述** 111 112网络链接信息。 113 114**起始版本：** 11 115 116 117### NetConn_HttpProxy 118 119``` 120typedef struct NetConn_HttpProxy NetConn_HttpProxy 121``` 122 123**描述** 124 125代理配置信息。 126 127**起始版本：** 11 128 129 130### NetConn_NetAddr 131 132``` 133typedef struct NetConn_NetAddr NetConn_NetAddr 134``` 135 136**描述** 137 138网络地址。 139 140**起始版本：** 11 141 142 143### NetConn_NetBearerType 144 145``` 146typedef enum NetConn_NetBearerType NetConn_NetBearerType 147``` 148 149**描述** 150 151网络载体类型。 152 153**起始版本：** 11 154 155 156### NetConn_NetCap 157 158``` 159typedef enum NetConn_NetCap NetConn_NetCap 160``` 161 162**描述** 163 164网络能力集。 165 166**起始版本：** 11 167 168 169### NetConn_NetCapabilities 170 171``` 172typedef struct NetConn_NetCapabilities NetConn_NetCapabilities 173``` 174 175**描述** 176 177网络能力集。 178 179**起始版本：** 11 180 181 182### NetConn_NetHandle 183 184``` 185typedef struct NetConn_NetHandle NetConn_NetHandle 186``` 187 188**描述** 189 190存放网络ID。 191 192**起始版本：** 11 193 194 195### NetConn_NetHandleList 196 197``` 198typedef struct NetConn_NetHandleList NetConn_NetHandleList 199``` 200 201**描述** 202 203网络列表。 204 205**起始版本：** 11 206 207 208### NetConn_Route 209 210``` 211typedef struct NetConn_Route NetConn_Route 212``` 213 214**描述** 215 216路由配置信息。 217 218**起始版本：** 11 219 220 221### OH_NetConn_CustomDnsResolver 222 223``` 224typedef int(* OH_NetConn_CustomDnsResolver) (const char *host, const char *serv, const struct addrinfo *hint, struct addrinfo **res) 225``` 226 227**描述** 228 229指向自定义 DNS 解析器的指针。 230 231**起始版本：** 11 232 233**参数:** 234 235| 名称 | 描述 | 236| -------- | -------- | 237| host | 要查询的主机名 | 238| serv | 服务名称 | 239| hint | 指向addrinfo结构的指针 | 240| res | 存储DNS查询结果并以链表形式返回 | 241 242 243### OH_NetConn_AppHttpProxyChange 244 245``` 246typedef void(* OH_NetConn_AppHttpProxyChange) (NetConn_HttpProxy *proxy) 247``` 248 249**描述** 250 251应用级代理变化回调指针。 252 253**起始版本：** 12 254 255**参数:** 256 257| 名称 | 描述 | 258| -------- | -------- | 259| proxy | 变化的代理配置信息（可能为空指针） | 260 261 262### NetConn_NetConnCallback 263 264``` 265typedef struct NetConn_NetConnCallback NetConn_NetConnCallback 266``` 267 268**描述** 269 270网络状态监听回调集合。 271 272**起始版本：** 12 273 274 275### NetConn_NetSpecifier 276 277``` 278typedef struct NetConn_NetSpecifier NetConn_NetSpecifier 279``` 280 281**描述** 282 283网络的特征集，包含网络的能力集与网络的标识符。 284 285**起始版本：** 12 286 287 288## 枚举类型说明 289 290 291### NetConn_NetBearerType 292 293``` 294enum NetConn_NetBearerType 295``` 296 297**描述** 298 299网络载体类型。 300 301**起始版本：** 11 302 303| 枚举值 | 描述 | 304| ------------------------| ----------------------- | 305| NETCONN_BEARER_CELLULAR | 蜂窝网络。 | 306| NETCONN_BEARER_WIFI | WIFI。 | 307| NETCONN_BEARER_BLUETOOTH | 蓝牙。<br/>起始版本：12。 | 308| NETCONN_BEARER_ETHERNET | Ethernet。 | 309| NETCONN_BEARER_VPN | VPN。<br/>起始版本：12。| 310 311 312### NetConn_NetCap 313 314``` 315enum NetConn_NetCap 316``` 317 318**描述** 319 320网络能力集。 321 322**起始版本：** 11 323 324| 枚举值 | 描述 | 325| -------- | -------- | 326| NETCONN_NET_CAPABILITY_MMS | MMS。 | 327| NETCONN_NET_CAPABILITY_NOT_METERED | 非计量网络。 | 328| NETCONN_NET_CAPABILITY_INTERNET | Internet。 | 329| NETCONN_NET_CAPABILITY_NOT_VPN | 非VPN。 | 330| NETCONN_NET_CAPABILITY_VALIDATED | 已验证。 | 331| NETCONN_NET_CAPABILITY_CHECKING_CONNECTIVITY | 检测连通性中。<br/>起始版本：12。 | 332 333 334## 函数说明 335 336 337### OH_NetConn_FreeDnsResult() 338 339``` 340int32_t OH_NetConn_FreeDnsResult (struct addrinfo * res) 341``` 342 343**描述** 344 345释放DNS结果。 346 347**系统能力：** SystemCapability.Communication.NetManager.Core 348 349**起始版本：** 11 350 351**参数:** 352 353| 名称 | 描述 | 354| -------- | -------- | 355| res | DNS查询结果链表头。 | 356 357**返回：** 358 3590 - 成功. 360 361201 - 缺少权限. 362 363401 - 参数错误. 364 3652100002 - 无法连接到服务. 366 3672100003 - 内部错误. 368 369**Permission：** 370 371ohos.permission.INTERNET 372 373 374### OH_NetConn_GetAddrInfo() 375 376``` 377int32_t OH_NetConn_GetAddrInfo (char * host, char * serv, struct addrinfo * hint, struct addrinfo ** res, int32_t netId ) 378``` 379 380**描述** 381 382通过netId获取DNS结果。 383 384**系统能力：** SystemCapability.Communication.NetManager.Core 385 386**起始版本：** 11 387 388**参数:** 389 390| 名称 | 描述 | 391| -------- | -------- | 392| host | 所需查询的host名. | 393| serv | 服务名. | 394| hint | 指向addrinfo结构体的指针. | 395| res | 存放DNS查询结果，以链表形式返回. | 396| netId | DNS查询netId 为0是使用默认netid查询. | 397 398**返回：** 399 4000 - 成功. 401 402201 - 缺少权限. 403 404401 - 参数错误. 405 4062100002 - 无法连接到服务. 407 4082100003 - 内部错误. 409 410**Permission：** 411 412ohos.permission.INTERNET 413 414 415### OH_NetConn_GetAllNets() 416 417``` 418int32_t OH_NetConn_GetAllNets (NetConn_NetHandleList * netHandleList) 419``` 420 421**描述** 422 423查询所有激活的数据网络。 424 425**系统能力：** SystemCapability.Communication.NetManager.Core 426 427**起始版本：** 11 428 429**参数:** 430 431| 名称 | 描述 | 432| -------- | -------- | 433| netHandleList | 网络信息列表. | 434 435**返回：** 436 4370 - 成功. 438 439201 - 缺少权限. 440 441401 - 参数错误. 442 4432100002 - 无法连接到服务. 444 4452100003 - 内部错误. 446 447**Permission：** 448 449ohos.permission.GET_NETWORK_INFO 450 451 452### OH_NetConn_GetConnectionProperties() 453 454``` 455int32_t OH_NetConn_GetConnectionProperties (NetConn_NetHandle * netHandle, NetConn_ConnectionProperties * prop ) 456``` 457 458**描述** 459 460查询某个数据网络的链路信息。 461 462**系统能力：** SystemCapability.Communication.NetManager.Core 463 464**起始版本：** 11 465 466**参数:** 467 468| 名称 | 描述 | 469| -------- | -------- | 470| nethandle | 存放网络ID. | 471| prop | 存放链路信息. | 472 473**返回：** 474 4750 - 成功. 476 477201 - 缺少权限. 478 479401 - 参数错误. 480 4812100002 - 无法连接到服务. 482 4832100003 - 内部错误. 484 485**Permission：** 486 487ohos.permission.GET_NETWORK_INFO 488 489 490### OH_NetConn_GetDefaultHttpProxy() 491 492``` 493int32_t OH_NetConn_GetDefaultHttpProxy (NetConn_HttpProxy * httpProxy) 494``` 495 496**描述** 497 498查询默认的网络代理。 499 500**系统能力：** SystemCapability.Communication.NetManager.Core 501 502**起始版本：** 11 503 504**参数:** 505 506| 名称 | 描述 | 507| -------- | -------- | 508| httpProxy | 存放代理配置信息. | 509 510**返回：** 511 5120 - 成功. 513 514201 - 缺少权限. 515 516401 - 参数错误. 517 5182100002 - 无法连接到服务. 519 5202100003 - 内部错误. 521 522 523### OH_NetConn_GetDefaultNet() 524 525``` 526int32_t OH_NetConn_GetDefaultNet (NetConn_NetHandle * netHandle) 527``` 528 529**描述** 530 531获取激活的默认的数据网络。 532 533**系统能力：** SystemCapability.Communication.NetManager.Core 534 535**起始版本：** 11 536 537**参数:** 538 539| 名称 | 描述 | 540| -------- | -------- | 541| netHandle | 存放网络ID. | 542 543**返回：** 544 5450 - 成功. 546 547201 - 缺少权限. 548 549401 - 参数错误. 550 5512100002 - 无法连接到服务. 552 5532100003 - 内部错误. 554 555**Permission：** 556 557ohos.permission.GET_NETWORK_INFO 558 559 560### OH_NetConn_GetNetCapabilities() 561 562``` 563int32_t OH_NetConn_GetNetCapabilities (NetConn_NetHandle * netHandle, NetConn_NetCapabilities * netCapacities ) 564``` 565 566**描述** 567 568查询某个网络的能力集。 569 570**系统能力：** SystemCapability.Communication.NetManager.Core 571 572**起始版本：** 11 573 574**参数:** 575 576| 名称 | 描述 | 577| -------- | -------- | 578| netHandle | 存放网络ID. | 579| netCapacities | 存放能力集. | 580 581**返回：** 582 5830 - 成功. 584 585201 - 缺少权限. 586 587401 - 参数错误. 588 5892100002 - 无法连接到服务. 590 5912100003 - 内部错误. 592 593**Permission：** 594 595ohos.permission.GET_NETWORK_INFO 596 597 598### OH_NetConn_HasDefaultNet() 599 600``` 601int32_t OH_NetConn_HasDefaultNet (int32_t * hasDefaultNet) 602``` 603 604**描述** 605 606查询是否有默认激活的数据网络。 607 608**系统能力：** SystemCapability.Communication.NetManager.Core 609 610**起始版本：** 11 611 612**参数:** 613 614| 名称 | 描述 | 615| -------- | -------- | 616| hasDefaultNet | 是否有默认网络。 | 617 618**返回：** 619 6200 - 成功. 621 622201 - 缺少权限. 623 624401 - 参数错误. 625 6262100002 - 无法连接到服务. 627 6282100003 - 内部错误. 629 630**Permission：** 631 632ohos.permission.GET_NETWORK_INFO 633 634 635### OH_NetConn_IsDefaultNetMetered() 636 637``` 638int32_t OH_NetConn_IsDefaultNetMetered (int32_t * isMetered) 639``` 640 641**描述** 642 643查询默认数据网络是否记流量。 644 645**系统能力：** SystemCapability.Communication.NetManager.Core 646 647**起始版本：** 11 648 649**参数:** 650 651| 名称 | 描述 | 652| -------- | -------- | 653| isMetered | 是否激活。 | 654 655**返回：** 656 6570 - 成功. 658 659201 - 缺少权限. 660 661401 - 参数错误. 662 6632100002 - 无法连接到服务. 664 6652100003 - 内部错误. 666 667**Permission：** 668 669ohos.permission.GET_NETWORK_INFO 670 671 672### OHOS_NetConn_RegisterDnsResolver() <sup>(deprecated)</sup> 673 674``` 675int32_t OHOS_NetConn_RegisterDnsResolver (OH_NetConn_CustomDnsResolver resolver) 676``` 677 678**描述** 679 680注册自定义 DNS 解析器。 681 682**系统能力：** SystemCapability.Communication.NetManager.Core 683 684**起始版本：** 11 685 686**废弃版本：** 13 687 688**替代接口：** [OH_NetConn_RegisterDnsResolver](#oh_netconn_registerdnsresolver) 689 690**参数:** 691 692| 名称 | 描述 | 693| -------- | -------- | 694| resolver | 指向自定义 DNS 解析器的指针。 | 695 696**返回：** 697 6980 - 成功. 699 700201 - 缺少权限. 701 702401 - 参数错误. 703 7042100002 - 无法连接到服务. 705 7062100003 - 内部错误. 707 708**Permission：** 709 710ohos.permission.INTERNET 711 712 713### OHOS_NetConn_UnregisterDnsResolver() <sup>(deprecated)</sup> 714 715``` 716int32_t OHOS_NetConn_UnregisterDnsResolver (void ) 717``` 718 719**描述** 720 721取消注册自定义 DNS 解析器。 722 723**系统能力：** SystemCapability.Communication.NetManager.Core 724 725**起始版本：** 11 726 727**废弃版本：** 13 728 729**替代接口：** [OH_NetConn_UnregisterDnsResolver](#oh_netconn_unregisterdnsresolver) 730 731**返回：** 732 7330 - 成功. 734 735201 - 缺少权限. 736 737401 - 参数错误. 738 7392100002 - 无法连接到服务. 740 7412100003 - 内部错误. 742 743**Permission：** 744 745ohos.permission.INTERNET 746 747 748### OH_NetConn_RegisterDnsResolver() 749 750``` 751int32_t OH_NetConn_RegisterDnsResolver (OH_NetConn_CustomDnsResolver resolver) 752``` 753 754**描述** 755 756注册自定义 DNS 解析器。 757 758**系统能力：** SystemCapability.Communication.NetManager.Core 759 760**起始版本：** 13 761 762**参数:** 763 764| 名称 | 描述 | 765| -------- | -------- | 766| resolver | 指向自定义 DNS 解析器的指针。 | 767 768**返回：** 769 7700 - 成功. 771 772201 - 缺少权限. 773 774401 - 参数错误. 775 7762100002 - 无法连接到服务. 777 7782100003 - 内部错误. 779 780**Permission：** 781 782ohos.permission.INTERNET 783 784 785### OH_NetConn_UnregisterDnsResolver() 786 787``` 788int32_t OH_NetConn_UnregisterDnsResolver (void ) 789``` 790 791**描述** 792 793取消注册自定义 DNS 解析器。 794 795**系统能力：** SystemCapability.Communication.NetManager.Core 796 797**起始版本：** 13 798 799**返回：** 800 8010 - 成功. 802 803201 - 缺少权限. 804 805401 - 参数错误. 806 8072100002 - 无法连接到服务. 808 8092100003 - 内部错误. 810 811**Permission：** 812 813ohos.permission.INTERNET 814 815 816### OH_NetConn_BindSocket() 817 818``` 819int32_t OH_NetConn_BindSocket (int32_t socketFd, NetConn_NetHandle * netHandle) 820``` 821 822**描述** 823 824将套接字与指定的网络进行绑定。 825 826**系统能力：** SystemCapability.Communication.NetManager.Core 827 828**起始版本：** 12 829 830**参数:** 831 832| 名称 | 描述 | 833| -------- | -------- | 834| socketFd | 用户创建的套接字. | 835| netHandle | 存放网络ID. | 836 837**返回：** 838 8390 - 成功. 840 841401 - 参数错误. 842 8432100002 - 无法连接到服务. 844 8452100003 - 内部错误. 846 847 848### OH_NetConn_SetAppHttpProxy() 849 850``` 851int32_t OH_NetConn_SetAppHttpProxy(NetConn_HttpProxy *httpProxy) 852``` 853 854**描述** 855 856设置应用级代理配置信息。 857 858**系统能力：** SystemCapability.Communication.NetManager.Core 859 860**起始版本：** 12 861 862**参数:** 863 864| 名称 | 描述 | 865| -------- | -------- | 866| httpProxy | 应用级代理配置信息。 | 867 868**返回：** 869 8700 - 成功. 871 872401 - 参数错误. 873 874 875### OH_NetConn_RegisterAppHttpProxyCallback() 876 877``` 878int32_t OH_NetConn_RegisterAppHttpProxyCallback(OH_NetConn_AppHttpProxyChange appHttpProxyChange, uint32_t *callbackId) 879``` 880 881**描述** 882 883注册监听应用级代理变化的回调。 884 885**系统能力：** SystemCapability.Communication.NetManager.Core 886 887**起始版本：** 12 888 889**参数:** 890 891| 名称 | 描述 | 892| -------- | -------- | 893| appHttpProxyChange | 指向应用级代理变化回调的指针。 | 894| callbackId | 关联本次注册的回调的id。 | 895 896**返回：** 897 8980 - 成功. 899 900401 - 参数错误. 901 902 903### OH_NetConn_UnregisterAppHttpProxyCallback() 904 905``` 906void OH_NetConn_UnregisterAppHttpProxyCallback(uint32_t callbackId) 907``` 908 909**描述** 910 911注销监听应用级代理变化的回调。 912 913**系统能力：** SystemCapability.Communication.NetManager.Core 914 915**起始版本：** 12 916 917**参数:** 918 919| 名称 | 描述 | 920| -------- | -------- | 921| callbackId | 关联需要注销的回调的id，此id在注册时得到。 | 922 923 924### OH_NetConn_RegisterNetConnCallback() 925 926``` 927int32_t OH_NetConn_RegisterNetConnCallback(NetConn_NetSpecifier *specifier, NetConn_NetConnCallback *netConnCallback, uint32_t timeout, uint32_t *callbackId) 928``` 929 930**描述** 931 932注册回调，用于监听特定的网络状态变更。 933 934**系统能力：** SystemCapability.Communication.NetManager.Core 935 936**起始版本：** 12 937 938**参数:** 939 940| 名称 | 描述 | 941| -------- | -------- | 942| specifier | 网络特征集。 | 943| netConnCallback | 注册的回调函数集合。 | 944| timeout | 等待时间，单位为毫秒，为0时表示无限等待。 | 945| callbackId | 出参，对应本次注册成功的回调。 | 946 947**返回：** 948 9490 - 成功. 950 951201 - 缺少权限. 952 953401 - 参数错误. 954 9552100002 - 无法连接到服务. 956 9572100003 - 内部错误. 958 9592101008 - 回调已注册. 960 9612101022 - 超过最大请求数. 962 963**Permission：** 964 965ohos.permission.GET_NETWORK_INFO 966 967 968### OH_NetConn_RegisterDefaultNetConnCallback() 969 970``` 971int32_t OH_NetConn_RegisterDefaultNetConnCallback(NetConn_NetConnCallback *netConnCallback, uint32_t *callbackId) 972``` 973 974**描述** 975 976注册回调，用于监听默认的网络状态变更。 977 978**系统能力：** SystemCapability.Communication.NetManager.Core 979 980**起始版本：** 12 981 982**参数:** 983 984| 名称 | 描述 | 985| -------- | -------- | 986| netConnCallback | 注册的回调函数集合。 | 987| callbackId | 出参，对应本次注册成功的回调。 | 988 989**返回：** 990 9910 - 成功. 992 993201 - 缺少权限. 994 995401 - 参数错误. 996 9972100002 - 无法连接到服务. 998 9992100003 - 内部错误. 1000 10012101008 - 回调已注册. 1002 10032101022 - 超过最大请求数. 1004 1005**Permission：** 1006 1007ohos.permission.GET_NETWORK_INFO 1008 1009 1010### OH_NetConn_UnregisterNetConnCallback() 1011 1012``` 1013int32_t OH_NetConn_UnregisterNetConnCallback(uint32_t callBackId) 1014``` 1015 1016**描述** 1017 1018注销网络状态监听回调。 1019 1020**系统能力：** SystemCapability.Communication.NetManager.Core 1021 1022**起始版本：** 12 1023 1024**参数:** 1025 1026| 名称 | 描述 | 1027| -------- | -------- | 1028| callBackId | 需要被注销的回调对应id。 | 1029 1030**返回：** 1031 10320 - 成功. 1033 1034201 - 缺少权限. 1035 1036401 - 参数错误. 1037 10382100002 - 无法连接到服务. 1039 10402100003 - 内部错误. 1041 10422101007 - 未找到相应回调. 1043 1044**Permission：** 1045 1046ohos.permission.GET_NETWORK_INFO