●函数
▪查询满足查询条件的Tag,普通点,报警点,统计点,计算点,SPC报警点都能查询
int32 tag3_query_tags_cond(
int64 nTagClassMask,
const HD3FilterItemSet*pSet,
int64 nPropMask,
HD3HANDLE* phResutSet);
●参数
nTagClassMask
[in] Tag类别掩码。
pSet
[in] 查询条件数组。
nPropMask
[in] 属性掩码(仅限共有属性)。
phResultSet
[out] 查询迭代器。
●返回值
查询成功,返回RD_SUCCESS。查询失败,返回错误码,见error_code.h。
●说明
▪szValue:属性项的值,用字符串表示。
例如:查询条件Tag name 以“上海”开头且 TagID小于1000的条件为:
根据查询条件查询满足查询条件的Tag,普通点、报警点、spc点、统计点、计算点都能查询。
调用该接口成功后会获得一个查询迭代器的句柄,然后调用ut3_get_item_step接口,传入迭代器句柄和分配的空间(HD3CommTagProp*),返回RD_SUCCESS就可以获得第一个点的属性,再调用ut3_get_item_step返回RD_SUCCESS就可以获得第二个点的属性。如此循环的查询直到调用ut3_get_item_step返回错误码为EC_HD_API_QUERY_END表明所有的点的属性都查询完毕了。查询完毕后调用ut3_free_iterator方法来释放迭代器。
●举例
示例代码参见数据源管理接口。
参见:
●tag3_query_tags_basic_info_by_name
©2015. All Rights Reserved.