pt3_add_tags

Navigation:  C++ > 普通点管理接口 >

pt3_add_tags

Previous pageReturn to chapter overviewNext page

函数

向服务器批量添加点

int32 pt3_add_tags(

       int32 nTagNum,

       const HD3PtTagProp* pTagPropArray,

       const HD3Mask* pMasksArray,

   const char* szDataNodeName,

       uint32* pTagIDArray,

       int32* pErrCodeArray

);

参数

nTagNum

    [in] tag点数。掩码必须包含TagName和TagType

pTagPropArray

    [in] 指向普通点属性结构体数组的指针。

pMasksArray

    [in] 属性掩码数组。掩码必须包含TagName和TagType

szDataNodeName

    [in] 数据节点名称,指定数据节点名称可以将点添加到指定数据节点,如果想由系统自动分配节点传入""或者NULL。

pTagIDArray

    [out] tag ID数组

pErrCodeArray

    [out] 错误码数组

返回值

添加成功,返回RD_SUCEESS。添加失败返回错误码,见error_code.h。

说明

属性掩码可以由单独的 42个属性项掩码组合而成,如TAG_PROP_TAG_NAME | TAG_PROP_TAG_TYPE表示属性掩码只包含Tag名和Tag类型这两个属性项。TAG_PROP_ALL表示包含所有的属性项。

添加普通点时,点的名称和点的类型必须添加。

掩码定义在文件hd3MaskDefine.h 里面

例如:Tag属性掩码  HD3M_COMM_PROP_TAG_NAME

举例

示例代码参见数据源管理接口

 

参见:

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