rdbapi 5.1.1.9 实时数据库C接口 for windows/Linux |

载入中...
搜索中...
未找到
函数
标签管理相关相关接口

## 函数
int | rdb_taginport (int h, unsigned int dwflag, rec_tag *ptag, int *presult)
| 导入(添加,更改)标签
int | rdb_tagget (int h, rec_tag *ptag)
| 读取标签属性记录
int | rdb_tagdel (int h, const char *sname)
| 删除标签
int | rdb_tagquery (int h, const char *snamefilter, const char *sdesfilter, int ndatatype, int ntagclass, rdbcb_OnReadTags pfun, void *pParam)
| 查询标签
int | rdb_tagext_inport (int h, tag_ext *pext, uint32_t umask)
| 导入标签扩展属性
int | rdb_tagext_get (int h, tag_ext *ptags, int size)
| 获取一批标签扩展属性
int | rdb_tagext_del (int h, const char *tagname)
| 删除一个标签的扩展属性

## 详细描述

标签查询，修改属性，增加删除等。

## 函数说明

## ◆ rdb_tagdel()

int rdb_tagdel | ( | int | h,
|  | const char * | sname )

删除标签

参数

  h | [in] rdb_create创建的句柄.
  sname | [in] 要删除的标签名.

返回
  返回 0 表示成功,其余值为失败错误码。

备注
  删除标签的同时删除历史数据并释放实时库内部逻辑存储页面。

## ◆ rdb_tagext_del()

int rdb_tagext_del | ( | int | h,
|  | const char * | tagname )

删除一个标签的扩展属性

参数

  h | rdb_create创建的句柄.
  tagname | [in] 标签名

返回
  0: success; 其他为错误码

## ◆ rdb_tagext_get()

int rdb_tagext_get | ( | int | h,
|  | tag_ext * | ptags,
|  | int | size )

获取一批标签扩展属性

参数

  h | [in] rdb_create创建的句柄.
  ptags | [in] in/out 标签扩展属性数组,输入时只填写标签名
  size | [in] ptags中标签个数

返回
  0: success; 其他为错误码

## ◆ rdb_tagext_inport()

int rdb_tagext_inport | ( | int | h,
|  | tag_ext * | pext,
|  | uint32_t | umask )

导入标签扩展属性

参数

  h | [in] rdb_create创建的句柄.
  pext | [in] 扩展属性结构体。
  umask | [in] 掩码

返回
  0: success; 其他为错误码

## ◆ rdb_tagget()

int rdb_tagget | ( | int | h,
|  | rec_tag * | ptag )

读取标签属性记录

参数

  h | [in] rdb_create创建的句柄.
  ptag | [in/out] 标签属性记录,调用前填写sname字段.

返回
  返回 0 表示成功,其余值为失败错误码。成功调用后,ptag的其余字段被填写.

## ◆ rdb_taginport()

int rdb_taginport | ( | int | h,
|  | unsigned int | dwflag,
|  | rec_tag * | ptag,
|  | int * | presult )

导入(添加,更改)标签

参数

  h | [in] rdb_create创建的句柄.
  dwflag | [in] 导入策略,指明当标签存在时修改哪些字段,参见TAG_MASK_DES
  ptag | [in] 标签记录指针
  presult | [out] 处理结果; 0未更改; 1修改了; 2添加了

返回
  返回 0 表示成功，其余值为失败错误码

## ◆ rdb_tagquery()

int rdb_tagquery | ( | int | h,
|  | const char * | snamefilter,
|  | const char * | sdesfilter,
|  | int | ndatatype,
|  | int | ntagclass,
|  | rdbcb_OnReadTags | pfun,
|  | void * | pParam )

查询标签

参数

  h | [in] rdb_create创建的句柄.
  snamefilter | [in] 标签名过滤串,空或*表示全部,支持*和?匹配
  sdesfilter | [in] 标签描述过滤串,空或*表示全部,支持*和?匹配
  ndatatype | [in] 标签名数据类型,-1表示全部
  ntagclass | [in] 标签分类,-1表示全部
  pfun | [in] 回调函数,参见rdbcb_OnReadTags,查询到标签记录后使用回调函数处理.
  pParam | [in] 回调函数的参数.

返回
  返回 0 表示成功,其余值为失败错误码。

备注
  当查询结束或者回调函数返回0时结束查询，也就是调用者可以中途终止查询.整个查询过程中，回调函数可能被调用多次.