harmony 鸿蒙data_asset.h

  • 2025-06-12
  • 浏览 (3)

data_asset.h

概述

提供资产类型数据结构。
资产是指可以一种可以在数据管理中使用的数据结构，可以存储及查询一个文件的名称、绝对路径、相对路径、创建时间、修改时间、状态、占用空间等属性。

引用文件：

库： libnative_rdb_ndk.z.so

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core

起始版本： 11

相关模块： RDB

汇总

结构体

|名称|typedef关键字|描述| |–|–|–| |Data_Asset|Data_Asset|表示资产附件类型的数据。
提供资产附件的信息。|

枚举

|名称|typedef关键字|描述| |–|–|–| |Data_AssetStatus|Data_AssetStatus|资产状态值类型。|

函数

|名称|描述| |–|–| |int OH_Data_Asset_SetName(Data_Asset *asset, const char *name)|设置资产类型数据的名称。| |int OH_Data_Asset_SetUri(Data_Asset *asset, const char *uri)|设置资产类型数据在系统里的绝对路径，即URI。| |int OH_Data_Asset_SetPath(Data_Asset *asset, const char *path)|设置资产类型数据在应用沙箱里的相对路径。| |int OH_Data_Asset_SetCreateTime(Data_Asset *asset, int64_t createTime)|设置资产类型数据创建的时间。| |int OH_Data_Asset_SetModifyTime(Data_Asset *asset, int64_t modifyTime)|设置资产类型数据最后修改的时间。| |int OH_Data_Asset_SetSize(Data_Asset *asset, size_t size)|设置资产类型数据占用空间的大小。| |int OH_Data_Asset_SetStatus(Data_Asset *asset, Data_AssetStatus status)|设置资产类型数据的状态码。| |int OH_Data_Asset_GetName(Data_Asset *asset, char *name, size_t *length)|获取资产类型数据的名称。| |int OH_Data_Asset_GetUri(Data_Asset *asset, char *uri, size_t *length)|获取资产类型数据的绝对路径。| |int OH_Data_Asset_GetPath(Data_Asset *asset, char *path, size_t *length)|获取资产类型数据的相对路径。| |int OH_Data_Asset_GetCreateTime(Data_Asset *asset, int64_t *createTime)|获取资产类型数据的创建时间。| |int OH_Data_Asset_GetModifyTime(Data_Asset *asset, int64_t *modifyTime)|获取资产类型数据的最后修改的时间。| |int OH_Data_Asset_GetSize(Data_Asset *asset, size_t *size)|获取资产类型数据占用空间的大小。| |int OH_Data_Asset_GetStatus(Data_Asset *asset, Data_AssetStatus *status)|获取资产类型数据的状态码。| |Data_Asset *OH_Data_Asset_CreateOne(void)|创造一个Data_Asset类型实例。| |int OH_Data_Asset_DestroyOne(Data_Asset *asset)|销毁Data_Asset 对象并回收该对象占用的内存。| |Data_Asset **OH_Data_Asset_CreateMultiple(uint32_t count)|创造指定数量的Data_Asset类型实例。| |int OH_Data_Asset_DestroyMultiple(Data_Asset **assets, uint32_t count)|销毁多个Data_Asset 对象并回收该对象占用的内存。|

枚举类型说明

Data_AssetStatus

enum Data_AssetStatus

描述

资产状态值类型。

起始版本： 11

|枚举项|描述| |–|–| |ASSET_NULL = 0|表示资产为空。| |ASSET_NORMAL|表示资产状态正常。| |ASSET_INSERT|表示资产需要插入到云端。| |ASSET_UPDATE|表示资产需要更新到云端。| |ASSET_DELETE|表示资产需要在云端删除。| |ASSET_ABNORMAL|表示资产状态异常。| |ASSET_DOWNLOADING|表示资产正在下载到本地设备。|

函数说明

OH_Data_Asset_SetName()

int OH_Data_Asset_SetName(Data_Asset *asset, const char *name)

描述

设置资产类型数据的名称。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |const char *name|表示要设置的名称。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_SetUri()

int OH_Data_Asset_SetUri(Data_Asset *asset, const char *uri)

描述

设置资产类型数据在系统里的绝对路径，即URI。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |uri| 表示要设置的URI。|

返回：

|类型|说明 | |–|———————————————————————————————————————————————| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_SetPath()

int OH_Data_Asset_SetPath(Data_Asset *asset, const char *path)

描述

设置资产类型数据在应用沙箱里的相对路径。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |const char *path|表示要设置的相对路径。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_SetCreateTime()

int OH_Data_Asset_SetCreateTime(Data_Asset *asset, int64_t createTime)

描述

设置资产类型数据创建的时间。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |int64_t createTime|表示要设置的创建时间。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_SetModifyTime()

int OH_Data_Asset_SetModifyTime(Data_Asset *asset, int64_t modifyTime)

描述

设置资产类型数据最后修改的时间。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |int64_t modifyTime|表示要设置的最后修改的时间。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_SetSize()

int OH_Data_Asset_SetSize(Data_Asset *asset, size_t size)

描述

设置资产类型数据占用空间的大小。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |size_t size|表示要设置的占用空间的大小。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_SetStatus()

int OH_Data_Asset_SetStatus(Data_Asset *asset, Data_AssetStatus status)

描述

设置资产类型数据的状态码。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |Data_AssetStatus status|表示需要设置的状态码。详细信息可以查看Data_AssetStatus。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_GetName()

int OH_Data_Asset_GetName(Data_Asset *asset, char *name, size_t *length)

描述

获取资产类型数据的名称。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |char *name|该参数是输出参数，资产类型数据的名称会以字符串形式写入该变量。| |size_t *length|表示name的长度。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_ERR表示函数执行异常。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_GetUri()

int OH_Data_Asset_GetUri(Data_Asset *asset, char *uri, size_t *length)

描述

获取资产类型数据的绝对路径。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |char *uri|参数是输出参数，资产类型数据的绝对路径会以字符串形式写入该变量。| |size_t *length|表示uri的长度。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_ERR表示函数执行异常。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_GetPath()

int OH_Data_Asset_GetPath(Data_Asset *asset, char *path, size_t *length)

描述

获取资产类型数据的相对路径。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |char *path|参数是输出参数，资产类型数据的相对路径会以字符串形式写入该变量。| |size_t *length|表示path的长度。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_ERR表示函数执行异常。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_GetCreateTime()

int OH_Data_Asset_GetCreateTime(Data_Asset *asset, int64_t *createTime)

描述

获取资产类型数据的创建时间。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |int64_t *createTime|参数是输出参数，资产类型数据的创建时间会以int64_t形式写入该变量。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_ERR表示函数执行异常。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

参考：

Data_Asset

OH_Data_Asset_GetModifyTime()

int OH_Data_Asset_GetModifyTime(Data_Asset *asset, int64_t *modifyTime)

描述

获取资产类型数据的最后修改的时间。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |int64_t *modifyTime|参数是输出参数，资产类型数据的最后修改时间会以int64_t形式写入该变量。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_ERR表示函数执行异常。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_GetSize()

int OH_Data_Asset_GetSize(Data_Asset *asset, size_t *size)

描述

获取资产类型数据占用空间的大小。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |size_t *size|参数是输出参数，资产类型数据的占用空间大小会以size_t形式写入该变量。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_ERR表示函数执行异常。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_GetStatus()

int OH_Data_Asset_GetStatus(Data_Asset *asset, Data_AssetStatus *status)

描述

获取资产类型数据的状态码。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。| |Data_AssetStatus *status|参数是输出参数，资产类型数据的状态码会以Data_AssetStatus形式写入该变量。|

返回：

|类型|说明| |–|–| |int|返回特定的错误码值。详细信息可以查看OH_Rdb_ErrCode。
返回RDB_OK表示成功。
返回RDB_E_INVALID_ARGS表示无效参数。|

OH_Data_Asset_CreateOne()

Data_Asset *OH_Data_Asset_CreateOne(void)

描述

创造一个Data_Asset类型实例。

起始版本： 11

返回：

|类型|说明| |–|–| |Data_Asset|创建成功则返回一个指向Data_Asset结构体实例的指针，否则返回NULL。|

OH_Data_Asset_DestroyOne()

int OH_Data_Asset_DestroyOne(Data_Asset *asset)

描述

销毁Data_Asset 对象并回收该对象占用的内存。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset *asset|表示指向Data_Asset实例的指针。|

返回：

|类型|说明| |–|–| |int|返回操作是否成功，成功时返回RDB_OK，出错时返回对应的错误码。详细信息可以查看OH_Rdb_ErrCode。|

OH_Data_Asset_CreateMultiple()

Data_Asset **OH_Data_Asset_CreateMultiple(uint32_t count)

描述

创造指定数量的Data_Asset类型实例。

起始版本： 11

参数：

|参数项|描述| |–|–| |uint32_t count|代表创建的资产类型数据的数量。|

返回：

|类型|说明| |–|–| |Data_Asset|创建成功则返回一个指向Data_Asset结构体实例的指针，否则返回NULL。|

OH_Data_Asset_DestroyMultiple()

int OH_Data_Asset_DestroyMultiple(Data_Asset **assets, uint32_t count)

描述

销毁多个Data_Asset 对象并回收该对象占用的内存。

起始版本： 11

参数：

|参数项|描述| |–|–| |Data_Asset **assets|表示指向Data_Asset实例的指针。| |uint32_t count|代表需要销毁的Data_Asset类型对象的数量。|

返回：

|类型|说明| |–|–| |int|返回操作是否成功，成功时返回RDB_OK，出错时返回对应的错误码。详细信息可以查看OH_Rdb_ErrCode。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkData（方舟数据管理）

harmony 鸿蒙Class (RdbPredicates)

harmony 鸿蒙arkts-apis-data-relationalStore-RdbStore

harmony 鸿蒙Interface (ResultSet)

harmony 鸿蒙Interface (Transaction)

harmony 鸿蒙Enums

harmony 鸿蒙Functions

harmony 鸿蒙Interfaces (其他)

harmony 鸿蒙Types

harmony 鸿蒙模块描述

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/bMkJOG
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录