●函数
▪查询所有数字状态集的名称。
int32 pt3_query_add_digitalsets(
HDHANDLE* phResultSet
);
●参数
▪phResultSet
[out] 查询迭代器。
●返回值
查询成功,返回RD_SUCCESS和查询迭代器。查询失败返回其它错误码,见error_code.h。
●说明
▪调用该接口成功后会获得一个查询迭代器的句柄,然后调用ut3_get_item_step接口,传入迭代器句柄和分配的空间(char[HD3_LEN_DIGITAL_SET_NAME]),返回RD_SUCCESS就可以获得第一个数字量状态集的名称,再调用ut3_get_item_step返回RD_SUCCESS就可以获得第二个数字量状态集的名称。如此循环的查询直到调用ut3_get_item_step返回错误码为EC_HD_API_QUERY_END表明所有的数字量状态集都查询完毕了。查询完毕后调用ut3_free_iterator方法来释放迭代器。
●举例
示例代码参见Digitalset管理接口。
参见:
▪pt3_query_digitalset_state_name
▪pt3_query_digitalset_all_state_infos
©2015. All Rights Reserved.