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。

    MCO_RET mco_iot_conn_release(
    	iot_connection_h iotc
    );

有关概述，请参阅主动复制结构页面。

参数

iotc

iot_connection_h

连接句柄。

返回

MCO_S_OK

连接已成功释放。

MCO_E_IOT_INVALID_HANDLE

连接句柄 iotc 无效。

示例

    conn = 0;
    while ((conn = mco_iot_comm_next_conn(comm, conn))) 
    {
        // 如果 prev 为 0 则重新开始；_next_conn() 会自动为之前的连接调用 release() 方法
      
        if (!condition) 
        {
            break;
        }
    }
    if (conn) 
    {
        mco_iot_conn_release(conn); // 显式释放连接
    }

文件

• 头文件：mcoiot.h
• 源文件：mcoiotcomm.c
• 库：libmcoiotcomm.a