●函数
▪根据查询条件查询满足条件的指定位置和指定个数的普通点
int32 pt3_query_specify_page_tags_cond(
HD3PageQueryTagParam* pParam,
HDHANDLE* phResultSet
)
●参数
▪pParam
[in] 查询条件。
▪phResultSet
[out] 结果集句柄。
●返回值
查询成功,返回RD_SUCCESS。查询失败,返回错误码,见error_code.h。
●说明
▪分页查询,条件查询满足过滤项的普通点的属性
▪从起始索引开始查询满足查询条件的指定数量的Tag,起始索引从0开始,按照TagID从小到大的顺序排列。
▪调用该接口成功后会获得一个查询迭代器的句柄,然后调用ut3_get_item_step接口,传入迭代器句柄和分配的空间(TagProp*),返回RD_SUCCESS就可以获得第一个普通点的属性,再调用ut3_get_item_step返回RD_SUCCESS就可以获得第二个普通点的属性。如此循环的查询直到调用ut3_get_item_step返回错误码为EC_HD_API_QUERY_END表明所有的普通点的ID都查询完毕了。查询完毕后调用ut3_free_iterator方法来释放迭代器。
●举例
示例代码参见数据源管理接口。
参见:
●tag3_query_tags_basic_info_by_name
©2015. All Rights Reserved.