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