●函数
▪获取结果项
int32 ut3_get_item_step(
HD3HANDLE hResultSet,
void* pItem
);
●参数
▪hResultSet
[in] 迭代器句柄。
▪pItem
[in] 结果项。
●返回值
查询成功,返回RD_SUCCESS,迭代器指向的内容通过参数pItem传出。EC_HD_API_QUERY_END,表明查询结束,失败返回其它错误码,见error_code.h
●说明
该接口需要配合其它查询接口一起使用,某些查询的接口如果查询成功会返回一个迭代器句柄,不断的调用ut3_get_item_step可以将要查询的内容一个一个全部取出来直到返回EC_HD_API_QUERY_END或者其它错误码。
参数pItem,根据调用的查询接口的不同,pItem指向不同的类型。例如调用am3_query_group_child_groups得到一个迭代器句柄,再调用ut3_get_item_step查询子组ID时,pItem为一个指向uint32类型的指针。调用am_query_tags_cond得到一个迭代器句柄,再调用ut3_get_item_step查询报警点属性时,pItem为一个指向HD3AlarmTagProp结构的指针。
使用完成后需要调用ut3_free_handle来释放迭代器。
●举例
示例代码参见管理功能接口。
参见:
●ut3_set_connection_checking_cycle
©2015. All Rights Reserved.