1# NetConn_NetConnCallback 2 3## 概述 4 5网络状态监听回调集合。 6 7**起始版本：** 12 8 9**相关模块：**[NetConnection](_net_connection.md) 10 11**所在头文件：** [net_connection_type.h](net__connection__type_8h.md#net_connection_typeh) 12 13## 汇总 14 15### 成员变量 16 17| 名称 | 描述 | 18| -------- | -------- | 19| [onNetworkAvailable](#onnetworkavailable) | 网络可用回调。 | 20| [onNetCapabilitiesChange](#onnetcapabilitieschange) | 网络能力集变更回调。 | 21| [onConnetionProperties](#onconnetionproperties) | 网络连接属性变更回调。 | 22| [onNetLost](#onnetlost) | 网络断开回调。 | 23| [onNetUnavailable](#onnetunavailable) | 网络不可用回调，在指定的超时时间内网络未激活时触发该回调，如果未设置超时时间则不会触发该回调。 | 24 25 26## 结构体成员变量说明 27 28 29### onNetworkAvailable 30 31``` 32typedef void (*OH_NetConn_NetworkAvailable)(NetConn_NetHandle *netHandle) 33``` 34 35**描述** 36 37网络可用回调。 38 39**说明** 40 41回调结束后参数内存会自动释放，不应保存参数指针。 42 43**参数:** 44 45| 名称 | 类型 | 描述 | 46| -------- | -------- | -------- | 47| netHandle |[NetHandle](js-apis-net-connection.md#nethandle) | 网络句柄。 | 48 49### onNetCapabilitiesChange 50 51``` 52typedef void (*OH_NetConn_NetCapabilitiesChange)(NetConn_NetHandle *netHandle, NetConn_NetCapabilities *netCapabilities) 53``` 54 55**描述** 56 57网络能力集变更回调。 58 59**说明** 60 61回调结束后参数内存会自动释放，不应保存参数指针。 62 63**参数:** 64 65| 名称 | 类型 | 描述 | 66| -------- | -------- | -------- | 67| netHandle | [NetHandle](js-apis-net-connection.md#nethandle) | 网络句柄。 | 68| netCapabilities | [NetCapabilities](js-apis-net-connection.md#netcapabilities)| 网络能力集。 | 69 70### onConnetionProperties 71 72``` 73typedef void (*OH_NetConn_NetConnectionPropertiesChange)(NetConn_NetHandle *netHandle, NetConn_ConnectionProperties *connConnetionProperties) 74``` 75 76**描述** 77 78网络连接属性变更回调。 79 80**说明** 81 82回调结束后参数内存会自动释放，不应保存参数指针。 83 84**参数:** 85 86| 名称 | 类型 | 描述 | 87| -------- | -------- | -------- | 88| netHandle |[NetHandle](js-apis-net-connection.md#nethandle) | 网络句柄。 | 89| connConnetionProperties | [ConnectionProperties](js-apis-net-connection.md#connectionproperties)| 网络连接属性。 | 90 91### onNetLost 92 93``` 94typedef void (*OH_NetConn_NetLost)(NetConn_NetHandle *netHandle) 95``` 96 97**描述** 98 99网络断开回调。 100 101**说明** 102 103回调结束后参数内存会自动释放，不应保存参数指针。 104 105**参数:** 106 107| 名称 | 类型 | 描述 | 108| -------- | -------- | -------- | 109| netHandle |[NetHandle](js-apis-net-connection.md#nethandle)| 网络句柄。 | 110 111### onNetUnavailable 112 113``` 114typedef void (*OH_NetConn_NetUnavailable)(void) 115``` 116 117**描述** 118 119网络不可用回调，在指定的超时时间内网络未激活时触发该回调，如果未设置超时时间则不会触发该回调。 120