C++ > SPC管理接口 > SPC报警点 > spc3_query_tags

●函数

查询条件查询满足条件的SPC报警点

int32 spc3_query_tags_cond(

const HD3FilterItemSet* pSet,

const HD3Mask* pMask,

HD3HANDLE* phResultSet

);

●参数

▪pSet

[in] 查询条件数组

▪pMask

[in] 返回报警点掩码，表明返回哪些报警点的属性。

▪phResultSet

[out] 查询迭代器。

●返回值

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

●说明

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

●举例

示例代码参见SPC报警点。

参见：

▪spc3_add_tag

▪spc3_add_tags

▪spc3_modify_tag_prop

▪spc3_modify_tags_prop

▪spc3_query_tag_prop

▪spc3_query_tags_cond

▪spc3_query_specify_page_tags_cond