●函数
▪向服务器添加一个普通点
int32 pt3_add_tag(
const HD3PtTagProp* pTagProp,
const HD3Mask* pMask;
const char* szDataNodeName,
uint32* pnTagID
);
●参数
▪pTagProp
[in] 指向普通点属性结构体的指针。
▪pMask
[in] 属性掩码。掩码必须包含TagName和TagType。
▪szDataNodeName
[in] 数据节点名称,指定数据节点名称可以将点添加到指定数据节点,如果想由系统自动分配节点传入""或者NULL。
▪pnTagID
[out]添加成功,该点对应的ID
●返回值
添加成功,返回RD_SUCEESS。添加失败返回错误码,见error_code.h。
●说明
属性掩码可以由单独的 42个属性项掩码组合而成包括33个基本属性和9个扩展属性,如HD3M_COMM_PROP_TAG_NAME | HD3M_COMM_PROP_TAG_TYPE表示属性掩码只包含Tag名和Tag类型这两个属性项。TAG_PROP_ALL表示包含所有的属性项。
添加普通点时,点的名称和点的类型必须添加。
掩码定义在文件hd3MaskDefine.h 里面
例如:Tag属性掩码 HD3M_COMM_PROP_TAG_NAME
●举例
示例代码参见数据源管理接口。
参见:
●tag3_query_tags_basic_info_by_name
©2015. All Rights Reserved.