C++ > 报警管理接口 > 报警点 > am3_query_specify_page_tags

●函数

▪分页查询：条件查询满足过滤性的报警点的属性

int32 am3_query_specify_page_tags_cond(

const HD3PageQueryTagParam* pParam,

HD3HANDLE* phResultSet

);

●参数

▪pParam

[in] 查询参数

▪phResultSet

[out] 结果集句柄。

●返回值

查询成功，返回RD_SUCCESS。查询失败返回其它错误码，见error_code.h。

●说明

szValue：属性项的值，用字符串表示。

例如：查询条件Tag name 以“上海”开头且 TagID小于1000的条件为：

从起始索引开始查询满足查询条件的指定数量的Tag，起始索引从0开始，按照TagID从小到大的顺序排列。

调用该接口成功后会获得一个查询迭代器的句柄，然后调用ut3_get_item_step接口，传入迭代器句柄和分配的空间(HD3AlarmTagProp*)，返回RD_SUCCESS就可以获得第一个报警点的属性，再调用ut3_get_item_step返回RD_SUCCESS就可以获得第二个普通点的属性。如此循环的查询直到调用ut3_get_item_step返回错误码为EC_HD_API_QUERY_END表明所有的报警点都查询完毕。查询完毕后调用ut3_free_handle方法来释放迭代器。

●举例

示例代码参见报警点接口。

参见：

▪am3_add_tag

▪am3_add_tags

▪am3_modify_tag_prop

▪am3_modify_tags_prop

▪am3_query_tag_prop

▪am3_query_tags_cond

▪am3_query_specify_page_tags_cond