# 管理网络连接(C/C++) ## 场景介绍 NetConnection模块提供了常用网络信息查询的能力。 ## 接口说明 NetConnection常用接口如下表所示，详细的接口说明请参考[net_connection.h](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-net-connection-h)。 |接口名|描述| |:----------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------| |OH_NetConn_HasDefaultNet(int32_t *hasDefaultNet)|检查默认数据网络是否被激活，判断设备是否有网络连接，以便在应用程序中采取相应的措施。| |OH_NetConn_GetDefaultNet(NetConn_NetHandle *netHandle)|获得默认激活的数据网络。| |OH_NetConn_IsDefaultNetMetered(int32_t *isMetered)|检查当前网络上的数据流量使用是否被计量。| |OH_NetConn_GetConnectionProperties(NetConn_NetHandle *netHandle, NetConn_ConnectionProperties *prop)|获取netHandle对应的网络的连接信息。| |OH_NetConn_GetNetCapabilities (NetConn_NetHandle *netHandle, NetConn_NetCapabilities *netCapacities)|获取netHandle对应的网络的能力信息。| |OH_NetConn_GetDefaultHttpProxy (NetConn_HttpProxy *httpProxy)|获取网络默认的代理配置信息。 如果设置了全局代理，则会返回全局代理配置信息。如果进程已经绑定到指定netHandle对应的网络，则返回网络句柄对应网络的代理配置信息。在其他情况下，将返回默认网络的代理配置信息。| |OH_NetConn_GetAddrInfo (char *host, char *serv, struct addrinfo *hint, struct addrinfo **res, int32_t netId)|通过netId获取DNS结果。| |OH_NetConn_FreeDnsResult(struct addrinfo *res)|释放DNS结果内存。| |OH_NetConn_GetAllNets(NetConn_NetHandleList *netHandleList)|获取所有处于连接状态的网络列表。| |OHOS_NetConn_RegisterDnsResolver(OH_NetConn_CustomDnsResolver resolver)|注册自定义DNS解析器。 **弃用：** 从API version 13开始废弃。 **替代：** 推荐使用OH_NetConn_RegisterDnsResolver。| |OHOS_NetConn_UnregisterDnsResolver(void)|取消注册自定义DNS解析器。 **弃用：** 从API version 13开始废弃。 **替代：** 推荐使用OH_NetConn_UnregisterDnsResolver。| |OH_NetConn_RegisterDnsResolver(OH_NetConn_CustomDnsResolver resolver)|注册自定义DNS解析器。| |OH_NetConn_UnregisterDnsResolver(void)|取消注册自定义DNS解析器。| |OH_NetConn_SetPacUrl(const char *pacUrl)|设置系统级代理自动配置(PAC)脚本地址。| |OH_NetConn_GetPacUrl(char *pacUrl)|获取系统级代理自动配置(PAC)脚本地址。| |OH_NetConn_QueryProbeResult(char *destination, int32_t duration, NetConn_ProbeResultInfo *probeResultInfo)|查询探测结果。| |OH_NetConn_QueryTraceRoute(char *destination, NetConn_TraceRouteOption *option, NetConn_TraceRouteInfo *traceRouteInfo)|查询跟踪路由。| ## 网络管理接口开发示例 ### 开发步骤 使用本文档涉及接口获取网络相关信息时，需先创建Native C++工程，在源文件中将相关接口封装，再在ArkTS层对封装的接口进行调用，使用hilog或者console.log等手段选择打印在控制台或者生成设备日志。 本文以实现获取默认激活的数据网络为例，给出具体的开发指导。 其他接口开发请参考：[完整示例代码](https://gitcode.com/openharmony/applications_app_samples/tree/master/code/DocsSample/NetWork_Kit/NetWorkKit_NetManager/NetConnection_Exploitation_case)。 ### 添加开发依赖 **添加动态链接库** CMakeLists.txt中添加以下lib: ```txt libace_napi.z.so libnet_connection.so ``` **头文件** #include "napi/native_api.h" #include "network/netmanager/net_connection.h" #include "network/netmanager/net_connection_type.h" ### 构建工程 1. 在源文件中编写调用该API的代码，并将结果封装成一个napi_value类型的值返回给Node.js环境。 // 获取默认网络的函数 static napi_value GetDefaultNet(napi_env env, napi_callback_info info) { size_t argc = 1; // 期望接收一个函数 napi_value args[1] = {nullptr}; // 存储接收到的参数 napi_get_cb_info(env, info, &argc, args, nullptr, nullptr); // ... int32_t param; napi_get_value_int32(env, args[0], ¶m); // 从 args[0] 获取整数值并存储到 param 中 NetConn_NetHandle netHandle; if (param == 0) { // 如果参数是0，传入NULL用于演示参数错误场景，接口将返回401 param = OH_NetConn_GetDefaultNet(NULL); } else { param = OH_NetConn_GetDefaultNet(&netHandle); } napi_value result; napi_create_int32(env, param, &result); return result; } // 获取默认网络ID的函数 static napi_value NetId(napi_env env, napi_callback_info info) { int32_t defaultNetId; NetConn_NetHandle netHandle; OH_NetConn_GetDefaultNet(&netHandle); defaultNetId = netHandle.netId; // 获取默认的 netId napi_value result; napi_create_int32(env, defaultNetId, &result); return result; } 简要说明：这两个函数用于获取系统默认网络连接的相关信息。其中，GetDefaultNet是接收ArkTS端传入的测试参数，返回调用接口后对应的返回值，param可以自行调整；如果返回值为0，代表获取成功，401代表参数错误，201代表没有权限；而NetId函数则用于获取默认网络连接的ID。这些信息可以用于进一步的网络操作。 2. 将通过napi封装好的napi_value类型对象初始化导出，通过外部函数接口，将以上两个函数暴露给JavaScript使用。 EXTERN_C_START static napi_value Init(napi_env env, napi_value exports) { // Information used to describe an exported attribute. Two properties are defined here: `GetDefaultNet` and `NetId`. napi_property_descriptor desc[] = { {"GetDefaultNet", nullptr, GetDefaultNet, nullptr, nullptr, nullptr, napi_default, nullptr}, {"NetId", nullptr, NetId, nullptr, nullptr, nullptr, napi_default, nullptr}, // ... }; napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc); return exports; } EXTERN_C_END 3. 将上一步中初始化成功的对象通过RegisterEntryModule函数，使用napi_module_register函数将模块注册到Node.js中。 static napi_module demoModule = { .nm_version = 1, .nm_flags = 0, .nm_filename = nullptr, .nm_register_func = Init, .nm_modname = "entry", .nm_priv = ((void *)0), .reserved = {0}, }; extern "C" __attribute__((constructor)) void RegisterEntryModule(void) { napi_module_register(&demoModule); } 4. 在工程的index.d.ts文件中定义两个函数的类型。 * GetDefaultNet函数接受一个数字参数code，返回一个数字类型的值。 * NetId函数不接受参数，返回一个数字类型的值。 ```TypeScript export const GetDefaultNet: (code: number) => number; export const NetId: () => number; ``` 5. 在index.ets文件中对上述封装好的接口进行调用。 ```TypeScript import testNetManager from 'libentry.so'; import { hilog } from '@kit.PerformanceAnalysisKit'; enum ReturnCode { SUCCESS = 0, // 操作成功 MISSING_PERMISSION = 201, // 缺少权限 PARAMETER_ERROR = 401, // 参数错误 } // ... @Entry @Component struct Index { @State message: string = ''; // 用于展示日志消息 // ... build() { Column() { // 显示 Logger 输出的日志 // ... Text(this.message) .fontSize(16) .fontColor(Color.Black) .margin({ bottom: 10 }) .id('test-message') // 为测试消息设置 ID，便于测试获取内容 Button($r('app.string.GetDefaultNet')) .onClick(() => { this.GetDefaultNet(); }) // ... Button($r('app.string.CodeNumber')) .onClick(() => { this.CodeNumber(); }) // ... }.width('100%').height('100%').justifyContent(FlexAlign.Center); } GetDefaultNet() { let netId = testNetManager.NetId(); // ... hilog.info(0x0000, 'testTag', 'The defaultNetId is [' + netId + ']'); // ... } CodeNumber() { // 非0表示传入有效的netHandle指针；0表示传入NULL，用于演示参数错误（401） let testParam = 1; // ... let codeNumber = testNetManager.GetDefaultNet(testParam); switch (codeNumber) { case ReturnCode.SUCCESS: hilog.info(0x0000, 'testTag', 'Test success. [' + codeNumber + ']'); // ... break; case ReturnCode.MISSING_PERMISSION: hilog.info(0x0000, 'testTag', 'Missing permissions. [' + codeNumber + ']'); // ... break; case ReturnCode.PARAMETER_ERROR: hilog.info(0x0000, 'testTag', 'Parameter error. [' + codeNumber + ']'); // ... break; default: hilog.info(0x0000, 'testTag', 'Unexpected result: [' + codeNumber + ']'); // ... break; } // ... } // ... } ``` 6. 配置CMakeLists.txt，本模块需要用到的共享库是libnet_connection.so，在工程自动生成的CMakeLists.txt中的target_link_libraries中添加此共享库。 > 注意 > > 如图所示，在add_library中的entry是工程自动生成的modname。若要做修改，需和步骤3中.nm_modname保持一致。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a0/v3/S2DRYNnkQqKQBXzGRE7iNA/zh-cn_image_0000002809050345.png?HW-CC-KV=V1&HW-CC-Date=20261102T125441Z&HW-CC-Expire=31536000000&HW-CC-Sign=60C55F54D271D5DFD211093F97CAFECD7716F58B80A6ECE030782E21CDCF2F24) 经过以上步骤，整个工程的搭建已经完成，接下来就可以连接设备运行工程进行日志查看了。 ## 测试步骤 1. 连接设备，使用DevEco Studio打开搭建好的工程。 2. 运行工程，设备上会弹出以下所示图片。 * 点击GetDefaultNet时获取的是默认网络ID。 * 点击codeNumber时获取的是接口返回的响应状态码。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/30/v3/__uDvoAcSgOKjX55Lli6FA/zh-cn_image_0000002779850780.png?HW-CC-KV=V1&HW-CC-Date=20261102T125441Z&HW-CC-Expire=31536000000&HW-CC-Sign=8E6BD9B8A95D058BDB83336B2E5A37097389120E527BC0FBA4C6AEA145682691) 3. 点击GetDefaultNet按钮，控制台会打印日志。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a0/v3/fl8Yv-1fRSO2el5RuzP5VQ/zh-cn_image_0000002779690812.png?HW-CC-KV=V1&HW-CC-Date=20261102T125441Z&HW-CC-Expire=31536000000&HW-CC-Sign=8FDA856D4F3B8F5442D23AE19FF6228807E85BC47D20AF363FF3F2331351AD4A) 4. 点击codeNumber按钮，控制台会打印相应的响应状态码。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a5/v3/3BVeubYZR7GVCXERfys37g/zh-cn_image_0000002809010433.png?HW-CC-KV=V1&HW-CC-Date=20261102T125441Z&HW-CC-Expire=31536000000&HW-CC-Sign=D75A1B571955EDB7B4F18DAD333F6688B39BA6F1708A3B2359B9489501E4C4B3)