tag3_query_tags_cond

Navigation:  C++ > 数据源管理接口 >

tag3_query_tags_cond

Previous pageReturn to chapter overviewNext page

 

函数

查询满足查询条件的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_delete_tag

tag3_delete_tags

tag3_query_id_by_name

tag3_query_ids_by_names

tag3_query_tag_num_cond

tag3_query_tags_basic_info_by_name

tag3_query_tags_comm_prop

tag3_query_tags_cond

 

©2015. All Rights Reserved.