mco_iot_comm_next_conn
此函数返回此通信器的下一个连接,并自动为前一个连接 prev
调用 mco_iot_conn_release()
。
此函数可用于列出所有活动连接,但它们的列出顺序未定义。
请注意,mco_iot_comm_find_conn()
和 mco_iot_comm_next_conn()
API 会“锁定/固定”连接句柄以保护句柄不被销毁。当不再需要句柄时,应通过调用 mco_iot_conn_release()
来移除“固定”。
从“固定/取消固定”的角度来看,更安全的枚举活动连接的方法是使用 mco_iot_replicator_enum_agents()
API。
iot_connection_h mco_iot_comm_next_conn(
mco_iot_comm_h comm,
iot_connection_h prev
) ;
有关概述,请参阅主动复制结构页面。
参数
comm
mco_iot_comm_h
通信器对象。
address
iot_connection_h
上一个连接。
返回
iot_connection_h
此通信器的下一个连接,若未找到则为 NULL
示例
{
conn = 0;
while ((conn = mco_iot_comm_next_conn(comm, conn)))
{
// if prev == 0 - start over; _next_conn() automatically calls release() for the previous connection
// Do something with connection conn
if (!condition)
{
break;
}
}
if (conn)
{
mco_iot_conn_release(conn); // explicitly release connection
}
}
文件
- 头文件:
mcoiot.h
- 源文件:
mcoiotcomm.c
- 库:
libmcoiotcomm.a