ut3_get_item_step

Navigation:  C++ > 管理功能接口 >

ut3_get_item_step

Previous pageReturn to chapter overviewNext page

 

函数

获取结果项

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_charset

ut3_get_charset

ut3_set_request_timeout

ut3_set_connection_checking_cycle

ut3_get_item_step

ut3_free_handle

ut3_get_server_time_ms

ut3_convert_sec_to_rdtime

ut3_convert_rdtime_to_sec

 

©2015. All Rights Reserved.