harmony 鸿蒙udmf.h

2025-06-12
浏览 (3)

udmf.h

概述

提供访问统一数据管理框架数据的接口、数据结构、枚举类型。

引用文件：

库： libudmf.so

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

起始版本： 12

相关模块： UDMF

汇总

结构体

枚举

函数

枚举类型说明

Udmf_Intention

enum Udmf_Intention

描述

描述UDMF数据通路枚举类型。

起始版本： 12

Udmf_ShareOption

enum Udmf_ShareOption

描述

UDMF支持的设备内使用范围类型枚举。

起始版本： 12

Udmf_FileConflictOptions

enum Udmf_FileConflictOptions

描述

定义文件拷贝冲突时的选项。

起始版本： 15

|枚举项|描述| |–|–| |UDMF_OVERWRITE = 0|目标路径存在同文件名时覆盖。若不配置策略，默认使用改策略。| |UDMF_SKIP = 1|目标路径存在同文件名时跳过。|

Udmf_ProgressIndicator

enum Udmf_ProgressIndicator

描述

定义进度条指示选项，可选择是否采用系统默认进度显示。

起始版本： 15

|枚举项|描述| |–|–| |UDMF_NONE = 0|不采用系统默认进度显示。| |UDMF_DEFAULT = 1|采用系统默认进度显示，500ms内获取数据完成将不会拉起默认进度条。|

函数说明

UDMF_KEY_BUFFER_LEN()

UDMF_KEY_BUFFER_LEN (512)

描述

统一数据对象唯一标识符最小空间长度。

起始版本： 12

OH_Udmf_DataProgressListener()

typedef void (*OH_Udmf_DataProgressListener)(OH_Udmf_ProgressInfo* progressInfo, OH_UdmfData* data)

描述

定义获取进度信息和数据的监听回调函数。
使用时需要判断数据是否返回空指针。只有当进度达到100%时，才会返回数据。

起始版本： 15

参数：

|参数项|描述| |–|–| |OH_Udmf_ProgressInfo* progressInfo|进度信息，作为出参使用。| |OH_UdmfData* data|返回的统一数据对象，作为出参使用。|

OH_UdmfData_Create()

OH_UdmfData* OH_UdmfData_Create()

描述

创建统一数据对象OH_UdmfData指针及实例对象。当不再需要使用指针时，请使用OH_UdmfData_Destroy销毁实例对象，否则会导致内存泄漏。

起始版本： 12

返回：

|类型|说明| |–|–| |OH_UdmfData*|执行成功则返回一个指向统一数据对象OH_UdmfData实例对象的指针，否则返回nullptr。|

参考：

OH_UdmfData

OH_UdmfData_Destroy()

void OH_UdmfData_Destroy(OH_UdmfData* pThis)

描述

销毁统一数据对象OH_UdmfData指针指向的实例对象。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfData* pThis|表示指向统一数据对象OH_UdmfData实例的指针。|

参考：

OH_UdmfData

OH_UdmfData_AddRecord()

int OH_UdmfData_AddRecord(OH_UdmfData* pThis, OH_UdmfRecord* record)

描述

添加一个数据记录OH_UdmfRecord到统一数据对象OH_UdmfData中。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfData* pThis|表示指向统一数据对象OH_UdmfData实例的指针。| |OH_UdmfRecord* record|表示指向统一数据记录OH_UdmfRecord实例的指针。|

返回：

|类型|说明| |–|–| |int|返回执行的错误码。请参阅错误码定义Udmf_ErrCode。
若返回UDMF_E_OK，表示执行成功。
若返回UDMF_E_INVALID_PARAM，表示传入了无效参数。|

OH_UdmfData_HasType()

bool OH_UdmfData_HasType(OH_UdmfData* pThis, const char* type)

描述

检查统一数据对象OH_UdmfData中是否存在指定类型。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfData* pThis|表示指向统一数据对象OH_UdmfData实例的指针。| |const char* type|表示指定类型的字符串指针。|

返回：

|类型|说明| |–|–| |bool|返回查找类型的状态。返回false表示不存在指定类型，返回true表示存在指定类型。|

OH_UdmfData_GetTypes()

char** OH_UdmfData_GetTypes(OH_UdmfData* pThis, unsigned int* count)

描述

获取统一数据对象OH_UdmfData中包含的所有类型结果集。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfData* pThis|表示指向统一数据对象OH_UdmfData实例的指针。| |unsigned int* count|该参数是输出参数，结果集中的类型数量会写入该变量。|

返回：

|类型|说明| |–|–| |char**|执行成功时返回统一数据对象的类型结果集，否则返回nullptr。|

OH_UdmfData_GetRecords()

OH_UdmfRecord** OH_UdmfData_GetRecords(OH_UdmfData* pThis, unsigned int* count)

描述

获取统一数据对象OH_UdmfData中包含的所有记录结果集。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfData* pThis|表示指向统一数据对象OH_UdmfData实例的指针。| |unsigned int* count|该参数是输出参数，结果集中的记录数量会写入该变量。|

返回：

|类型|说明| |–|–| |OH_UdmfRecord**|执行成功时返回统一数据记录OH_UdmfRecord结果集，否则返回nullptr。|

UdmfData_Finalize()

typedef void (*UdmfData_Finalize)(void* context)

描述

定义用于释放上下文的回调函数，统一数据提供者对象销毁时触发。

起始版本： 13

参数：

|参数项|描述| |–|–| |void* context|要释放的上下文指针。|

OH_UdmfRecordProvider_Create()

OH_UdmfRecordProvider* OH_UdmfRecordProvider_Create()

描述

创建一个统一数据提供者OH_UdmfRecordProvider指针及实例对象。当不再需要使用指针时，请使用OH_UdmfRecordProvider_Destroy销毁实例对象，否则会导致内存泄漏。

起始版本： 13

返回：

|类型|说明| |–|–| |OH_UdmfRecordProvider*|执行成功时返回一个指向统一数据提供者OH_UdmfRecordProvider实例对象的指针，否则返回nullptr。|

OH_UdmfRecordProvider_Destroy()

int OH_UdmfRecordProvider_Destroy(OH_UdmfRecordProvider* provider)

描述

销毁统一数据提供者OH_UdmfRecordProvider指针指向的实例对象。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfRecordProvider* provider|表示指向统一数据提供者对象OH_UdmfRecordProvider实例的指针。|

返回：

OH_UdmfRecordProvider_GetData()

typedef void* (*OH_UdmfRecordProvider_GetData)(void* context, const char* type)

描述

定义用于按类型获取数据的回调函数。当从OH_UdmfRecord中获取数据时，会触发此回调函数，得到的数据就是这个回调函数返回的数据。

起始版本： 13

参数：

|参数项|描述| |–|–| |void* context|用OH_UdmfRecordProvider_SetData设置的上下文指针。| | const char* type|要获取的数据类型。详细类型信息见udmf_meta.h。|

返回：

|类型|说明| |–|–| |void*|需要返回一个标准化数据。|

OH_UdmfRecordProvider_SetData()

int OH_UdmfRecordProvider_SetData(OH_UdmfRecordProvider* provider, void* context, const OH_UdmfRecordProvider_GetData callback, const UdmfData_Finalize finalize)

描述

设置统一数据提供者的数据提供回调函数。

起始版本： 13

参数：

返回：

OH_UdmfRecord_Create()

OH_UdmfRecord* OH_UdmfRecord_Create()

描述

创建统一数据记录OH_UdmfRecord指针及实例对象。当不再需要使用指针时，请使用OH_UdmfRecord_Destroy销毁实例对象，否则会导致内存泄漏。

起始版本： 12

返回：

|类型|说明| |–|–| |OH_UdmfRecord*|执行成功则返回一个指向统一数据记录OH_UdmfRecord实例对象的指针，否则返回nullptr。|

OH_UdmfRecord_Destroy()

void OH_UdmfRecord_Destroy(OH_UdmfRecord* pThis)

描述

销毁统一数据记录OH_UdmfRecord指针指向的实例对象。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据对象OH_UdmfRecord实例的指针。|

OH_UdmfRecord_AddGeneralEntry()

int OH_UdmfRecord_AddGeneralEntry(OH_UdmfRecord* pThis, const char* typeId, unsigned char* entry, unsigned int count)

描述

添加用户自定义的通用数据至统一数据记录OH_UdmfRecord中。对于已定义UDS的类型（比如PlainText、Link、Pixelmap等）不可使用该接口。

起始版本： 12

参数：

返回：

OH_UdmfRecord_AddPlainText()

int OH_UdmfRecord_AddPlainText(OH_UdmfRecord* pThis, OH_UdsPlainText* plainText)

描述

增加纯文本类型OH_UdsPlainText数据至统一数据记录OH_UdmfRecord中。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsPlainText* plainText|表示指向纯文本类型OH_UdsPlainText实例的指针。|

返回：

OH_UdmfRecord_AddHyperlink()

int OH_UdmfRecord_AddHyperlink(OH_UdmfRecord* pThis, OH_UdsHyperlink* hyperlink)

描述

增加超链接类型OH_UdsHyperlink数据至统一数据记录OH_UdmfRecord中。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsHyperlink* hyperlink|表示指向超链接类型OH_UdsHyperlink实例的指针。|

返回：

OH_UdmfRecord_AddHtml()

int OH_UdmfRecord_AddHtml(OH_UdmfRecord* pThis, OH_UdsHtml* html)

描述

增加超文本标记语言类型OH_UdsHtml数据至统一数据记录OH_UdmfRecord中。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsHtml* html|表示指向超文本标记语言类型OH_UdsHtml实例的指针。|

返回：

OH_UdmfRecord_AddAppItem()

int OH_UdmfRecord_AddAppItem(OH_UdmfRecord* pThis, OH_UdsAppItem* appItem)

描述

增加桌面图标类型OH_UdsAppItem数据至统一数据记录OH_UdmfRecord中。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsAppItem* appItem|表示指向桌面图标类型OH_UdsAppItem实例的指针。|

返回：

OH_UdmfRecord_AddFileUri()

int OH_UdmfRecord_AddFileUri(OH_UdmfRecord* pThis, OH_UdsFileUri* fileUri)

描述

增加文件Uri类型OH_UdsFileUri数据至统一数据记录OH_UdmfRecord中。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsFileUri* fileUri|表示指向文件Uri类型OH_UdsFileUri实例的指针。|

返回：

OH_UdmfRecord_AddPixelMap()

int OH_UdmfRecord_AddPixelMap(OH_UdmfRecord* pThis, OH_UdsPixelMap* pixelMap)

描述

增加像素图片类型OH_UdsPixelMap数据至统一数据记录OH_UdmfRecord中。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsPixelMap* pixelMap|表示指向像素图片类型OH_UdsPixelMap实例的指针。|

返回：

OH_UdmfRecord_AddArrayBuffer()

int OH_UdmfRecord_AddArrayBuffer(OH_UdmfRecord* record, const char* type, OH_UdsArrayBuffer* buffer)

描述

增加一个ArrayBuffer类型OH_UdsArrayBuffer的数据至统一数据记录OH_UdmfRecord中。

起始版本： 13

参数：

返回：

OH_UdmfRecord_AddContentForm()

int OH_UdmfRecord_AddContentForm(OH_UdmfRecord* pThis, OH_UdsContentForm* contentForm)

描述

增加一个内容卡片类型OH_UdsContentForm的数据至统一数据记录OH_UdmfRecord中。

起始版本： 14

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsContentForm* contentForm|表示指向内容卡片类型OH_UdsContentForm实例的指针。|

返回：

OH_UdmfRecord_GetTypes()

char** OH_UdmfRecord_GetTypes(OH_UdmfRecord* pThis, unsigned int* count)

描述

获取统一数据记录OH_UdmfRecord中所有类型的结果集。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |unsigned int* count|该参数是输出参数，结果集中的类型数量会写入该变量。|

返回：

|类型|说明| |–|–| |char**|执行成功时返回类型列表，否则返回nullptr。|

OH_UdmfRecord_GetGeneralEntry()

int OH_UdmfRecord_GetGeneralEntry(OH_UdmfRecord* pThis, const char* typeId, unsigned char** entry, unsigned int* count)

描述

获取统一数据记录OH_UdmfRecord中的特定类型的数据结果集。

起始版本： 12

参数：

返回：

|类型|说明| |–|–| |int|返回执行的错误码。请参阅错误码定义Udmf_ErrCode。
若返回UDMF_E_OK，表示执行成功。
若返回UDMF_E_INVALID_PARAM，表示传入了无效参数。
若返回UDMF_ERR，表示内部数据错误。|

OH_UdmfRecord_GetPlainText()

int OH_UdmfRecord_GetPlainText(OH_UdmfRecord* pThis, OH_UdsPlainText* plainText)

描述

从统一数据记录OH_UdmfRecord中获取纯文本类型OH_UdsPlainText数据。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsPlainText* plainText|该参数是输出参数，表示指向纯文本类型OH_UdsPlainText实例的指针。|

返回：

OH_UdmfRecord_GetHyperlink()

int OH_UdmfRecord_GetHyperlink(OH_UdmfRecord* pThis, OH_UdsHyperlink* hyperlink)

描述

从统一数据记录OH_UdmfRecord中获取超链接类型OH_UdsHyperlink数据。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsHyperlink* hyperlink|该参数是输出参数，表示指向超链接类型OH_UdsHyperlink实例的指针。|

返回：

OH_UdmfRecord_GetHtml()

int OH_UdmfRecord_GetHtml(OH_UdmfRecord* pThis, OH_UdsHtml* html)

描述

从统一数据记录OH_UdmfRecord中获取超文本标记语言类型OH_UdsHtml数据。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsHtml* html|该参数是输出参数，表示指向超文本标记语言类型OH_UdsHtml实例的指针。|

返回：

OH_UdmfRecord_GetAppItem()

int OH_UdmfRecord_GetAppItem(OH_UdmfRecord* pThis, OH_UdsAppItem* appItem)

描述

从统一数据记录OH_UdmfRecord中获取桌面图标类型OH_UdsAppItem数据。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsAppItem* appItem|该参数是输出参数，表示指向桌面图标类型OH_UdsAppItem实例的指针。|

返回：

OH_UdmfRecord_SetProvider()

int OH_UdmfRecord_SetProvider(OH_UdmfRecord* pThis, const char* const* types, unsigned int count, OH_UdmfRecordProvider* provider)

描述

将指定类型的统一数据提供者OH_UdmfRecordProvider设置至统一数据记录OH_UdmfRecord中。

起始版本： 13

参数：

返回：

OH_UdmfRecord_GetFileUri()

int OH_UdmfRecord_GetFileUri(OH_UdmfRecord* pThis, OH_UdsFileUri* fileUri)

描述

从统一数据记录OH_UdmfRecord中获取文件Uri类型OH_UdsFileUri数据。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsFileUri* fileUri|该参数是输出参数，表示指向文件Uri类型OH_UdsFileUri实例的指针。|

返回：

OH_UdmfRecord_GetPixelMap()

int OH_UdmfRecord_GetPixelMap(OH_UdmfRecord* pThis, OH_UdsPixelMap* pixelMap)

描述

从统一数据记录OH_UdmfRecord中获取像素图片类型OH_UdsPixelMap数据。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsPixelMap* pixelMap|该参数是输出参数，表示指向像素图片类型OH_UdsPixelMap实例的指针。|

返回：

OH_UdmfRecord_GetArrayBuffer()

int OH_UdmfRecord_GetArrayBuffer(OH_UdmfRecord* record, const char* type, OH_UdsArrayBuffer* buffer)

描述

从统一数据记录OH_UdmfRecord中获取ArrayBuffer类型OH_UdsArrayBuffer数据。

起始版本： 13

参数：

返回：

OH_UdmfRecord_GetContentForm()

int OH_UdmfRecord_GetContentForm(OH_UdmfRecord* pThis, OH_UdsContentForm* contentForm)

描述

从统一数据记录OH_UdmfRecord中获取内容卡片类型OH_UdsContentForm数据。

起始版本： 14

参数：

|参数项|描述| |–|–| |OH_UdmfRecord* pThis|表示指向统一数据记录OH_UdmfRecord实例的指针。| |OH_UdsContentForm* contentForm|该参数是输出参数，表示指向内容卡片类型OH_UdsContentForm实例的指针。|

返回：

OH_UdmfData_GetPrimaryPlainText()

int OH_UdmfData_GetPrimaryPlainText(OH_UdmfData* data, OH_UdsPlainText* plainText)

描述

从统一数据对象OH_UdmfData中获取第一个纯文本类型OH_UdsPlainText数据。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfData* data|表示指向统一数据对象OH_UdmfData实例的指针。| |OH_UdsPlainText* plainText|该参数是输出参数，表示指向纯文本类型OH_UdsPlainText实例的指针。|

返回：

OH_UdmfData_GetPrimaryHtml()

int OH_UdmfData_GetPrimaryHtml(OH_UdmfData* data, OH_UdsHtml* html)

描述

从统一数据对象OH_UdmfData中获取第一个超文本标记语言类型OH_UdsHtml数据。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfData* data|表示指向统一数据对象OH_UdmfData实例的指针。| |OH_UdsHtml* html|该参数是输出参数，表示指向超文本标记语言类型OH_UdsHtml实例的指针。|

返回：

OH_UdmfData_GetRecordCount()

int OH_UdmfData_GetRecordCount(OH_UdmfData* data)

描述

获取统一数据对象OH_UdmfData中包含的所有记录数量。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfData* data|表示指向统一数据对象OH_UdmfData实例的指针。|

返回：

|类型|说明| |–|–| |int|返回统一数据对象OH_UdmfRecord的数量。|

OH_UdmfData_GetRecord()

OH_UdmfRecord* OH_UdmfData_GetRecord(OH_UdmfData* data, unsigned int index)

描述

获取统一数据对象OH_UdmfData中指定位置的数据记录。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfData* data|表示指向统一数据对象OH_UdmfData实例的指针。| |unsigned int index|表示要获取的统一数据记录OH_UdmfRecord在统一数据对象OH_UdmfData中的下标。|

返回：

|类型|说明| |–|–| |OH_UdmfRecord*|执行成功时返回统一数据记录OH_UdmfRecord实例对象的指针，否则返回nullptr。|

OH_UdmfData_IsLocal()

bool OH_UdmfData_IsLocal(OH_UdmfData* data)

描述

检查统一数据对象OH_UdmfData是否是来自本端设备的数据。

起始版本： 13

参数：

|参数项|描述| |–|–| |OH_UdmfData* data|表示指向统一数据对象OH_UdmfData实例的指针。|

返回：

|类型|说明| |–|–| |bool|返回数据是否是来自本端设备。返回true表示来自本端设备，返回false表示来自远端设备。|

OH_UdmfProperty_Create()

OH_UdmfProperty* OH_UdmfProperty_Create(OH_UdmfData* unifiedData)

描述

创建统一数据对象中数据记录属性OH_UdmfProperty指针及实例对象。当不再需要使用指针时，请使用OH_UdmfProperty_Destroy销毁实例对象，否则会导致内存泄漏。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfData* unifiedData|表示指向统一数据对象OH_UdmfData实例的指针。|

返回：

|类型|说明| |–|–| |OH_UdmfProperty*|执行成功则返回一个指向属性OH_UdmfProperty实例对象的指针，否则返回nullptr。|

OH_UdmfProperty_Destroy()

void OH_UdmfProperty_Destroy(OH_UdmfProperty* pThis)

描述

销毁数据属性OH_UdmfProperty指针指向的实例对象。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfProperty* pThis|表示指向数据属性OH_UdmfProperty实例的指针。|

OH_UdmfProperty_GetTag()

const char* OH_UdmfProperty_GetTag(OH_UdmfProperty* pThis)

描述

从数据属性OH_UdmfProperty中获取用户自定义标签值。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfProperty* pThis|表示指向数据属性OH_UdmfProperty实例的指针。|

返回：

|类型|说明| |–|–| |const char*|执行成功时返回自定义标签值的字符串指针，否则返回nullptr。|

OH_UdmfProperty_GetTimestamp()

int64_t OH_UdmfProperty_GetTimestamp(OH_UdmfProperty* pThis)

描述

从数据属性OH_UdmfProperty中获取时间戳。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfProperty* pThis|表示指向数据属性OH_UdmfProperty实例的指针。|

返回：

|类型|说明| |–|–| |int64_t|返回时间戳值。|

OH_UdmfProperty_GetShareOption()

Udmf_ShareOption OH_UdmfProperty_GetShareOption(OH_UdmfProperty* pThis)

描述

从数据属性OH_UdmfProperty中获取设备内适用范围属性。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfProperty* pThis|表示指向数据属性OH_UdmfProperty实例的指针。|

返回：

|类型|说明| |–|–| |Udmf_ShareOption|返回设备内适用范围属性Udmf_ShareOption值。|

OH_UdmfProperty_GetExtrasIntParam()

int OH_UdmfProperty_GetExtrasIntParam(OH_UdmfProperty* pThis, const char* key, int defaultValue)

描述

从数据属性OH_UdmfProperty中获取自定义的附加整型参数。

起始版本： 12

参数：

返回：

|类型|说明| |–|–| |int|执行成功返回指定的键关联的整型值，否则返回用户设置的默认值defaultValue。|

OH_UdmfProperty_GetExtrasStringParam()

const char* OH_UdmfProperty_GetExtrasStringParam(OH_UdmfProperty* pThis, const char* key)

描述

从数据属性OH_UdmfProperty中获取自定义的附加字符串参数。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfProperty* pThis|表示指向数据属性OH_UdmfProperty实例的指针。| |const char* key|表示键值对的键。|

返回：

|类型|说明| |–|–| |const char*|执行成功时返回指定的键关联的字符串值的指针，否则返回nullptr。|

OH_UdmfProperty_SetTag()

int OH_UdmfProperty_SetTag(OH_UdmfProperty* pThis, const char* tag)

描述

设置数据属性OH_UdmfProperty的自定义标签值。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfProperty* pThis|表示指向数据属性OH_UdmfProperty实例的指针。| |const char* tag|表示自定义标签值。|

返回：

OH_UdmfProperty_SetShareOption()

int OH_UdmfProperty_SetShareOption(OH_UdmfProperty* pThis, Udmf_ShareOption option)

描述

设置数据属性OH_UdmfProperty的设备内适用范围Udmf_ShareOption参数。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_UdmfProperty* pThis|表示指向数据属性OH_UdmfProperty实例的指针。| |Udmf_ShareOption option|表示设备内适用范围Udmf_ShareOption参数。|

返回：

OH_UdmfProperty_SetExtrasIntParam()

int OH_UdmfProperty_SetExtrasIntParam(OH_UdmfProperty* pThis, const char* key, int param)

描述

设置数据属性OH_UdmfProperty的附加整型参数。

起始版本： 12

参数：

返回：

OH_UdmfProperty_SetExtrasStringParam()

int OH_UdmfProperty_SetExtrasStringParam(OH_UdmfProperty* pThis, const char* key, const char* param)

描述

设置数据属性OH_UdmfProperty的附加字符串参数。

起始版本： 12

参数：

返回：

OH_UdmfOptions_Create()

OH_UdmfOptions* OH_UdmfOptions_Create()

描述

创建指向OH_UdmfOptions实例的指针。

起始版本： 20

返回：

|类型|说明| |–|–| |OH_UdmfOptions*|执行成功则返回一个指向数据操作选项OH_UdmfOptions实例的指针，否则返回nullptr。|

OH_UdmfOptions_Destroy()

void OH_UdmfOptions_Destroy(OH_UdmfOptions* pThis)

描述

销毁指向OH_UdmfOptions实例的指针。

起始版本： 20

参数：

|参数项|描述| |–|–| |OH_UdmfOptions* pThis|指向数据操作选项OH_UdmfOptions实例的指针。|

OH_UdmfOptions_GetKey()

const char* OH_UdmfOptions_GetKey(OH_UdmfOptions* pThis)

描述

从数据操作选项OH_UdmfOptions实例中获取数据的唯一标识符信息。

起始版本： 20

参数：

|参数项|描述| |–|–| |OH_UdmfOptions* pThis|指向数据操作选项OH_UdmfOptions实例的指针。|

返回：

|类型|说明| |–|–| |const char*|输入有效入参时返回符串指针，否则返回nullptr。|

OH_UdmfOptions_SetKey()

int OH_UdmfOptions_SetKey(OH_UdmfOptions* pThis, const char* key)

描述

设置数据操作选项OH_UdmfOptions实例中的数据的唯一标识符内容参数。

起始版本： 20

参数：

|参数项|描述| |–|–| |OH_UdmfOptions* pThis|指向数据操作选项OH_UdmfOptions实例的指针。| |const char* key|数据的唯一标识符的新字符串值。|

返回：

OH_UdmfOptions_GetIntention()

Udmf_Intention OH_UdmfOptions_GetIntention(OH_UdmfOptions* pThis)

描述

从数据操作选项OH_UdmfOptions实例中获取数据通路信息。

起始版本： 20

参数：

|参数项|描述| |–|–| |OH_UdmfOptions* pThis|指向数据操作选项OH_UdmfOptions实例的指针。|

返回：

|类型|说明| |–|–| |Udmf_Intention|返回Udmf_Intention的值。|

OH_UdmfOptions_SetIntention()

int OH_UdmfOptions_SetIntention(OH_UdmfOptions* pThis, Udmf_Intention intention)

描述

设置数据操作选项OH_UdmfOptions实例中的数据通路内容参数。

起始版本： 20

参数：

|参数项|描述| |–|–| |OH_UdmfOptions* pThis|指向数据操作选项OH_UdmfOptions实例的指针。| |Udmf_Intention intention|数据通路类型参数。|

返回：

OH_UdmfOptions_Reset()

int OH_UdmfOptions_Reset(OH_UdmfOptions* pThis)

描述

重置数据操作选项OH_UdmfOptions实例为空。

起始版本： 20

参数：

|参数项|描述| |–|–| |OH_UdmfOptions* pThis|指向数据操作选项OH_UdmfOptions实例的指针。|

返回：

OH_Udmf_GetUnifiedData()

int OH_Udmf_GetUnifiedData(const char* key, Udmf_Intention intention, OH_UdmfData* unifiedData)

描述

从统一数据管理框架数据库中获取统一数据对象OH_UdmfData数据。

起始版本： 12

参数：

返回：

OH_Udmf_GetUnifiedDataByOptions()

int OH_Udmf_GetUnifiedDataByOptions(OH_UdmfOptions* options, OH_UdmfData** dataArray, unsigned int* dataSize)

描述

通过数据通路类型从统一数据管理框架数据库中获取统一数据对象OH_UdmfData数据。

起始版本： 20

参数：

返回：

OH_Udmf_SetUnifiedData()

int OH_Udmf_SetUnifiedData(Udmf_Intention intention, OH_UdmfData* unifiedData, char* key, unsigned int keyLen)

描述

从统一数据管理框架数据库中写入统一数据对象OH_UdmfData数据。

起始版本： 12

参数：

|参数项|描述| |–|–| |Udmf_Intention intention|表示数据通路类型Udmf_Intention。| |OH_UdmfData* unifiedData|表示统一数据对象OH_UdmfData数据。| |key表示成功将数据设置到数据库后对应数据的唯一标识符。|| |unsigned int keyLen|表示唯一标识符参数的空间大小，内存大小不小于512字节。|

返回：

OH_Udmf_SetUnifiedDataByOptions()

int OH_Udmf_SetUnifiedDataByOptions(OH_UdmfOptions* options, OH_UdmfData *unifiedData, char *key, unsigned int keyLen)

描述

从统一数据管理框架数据库中写入统一数据对象OH_UdmfData数据。

起始版本： 20

参数：

返回：

OH_Udmf_UpdateUnifiedData()

int OH_Udmf_UpdateUnifiedData(OH_UdmfOptions* options, OH_UdmfData* unifiedData)

描述

对统一数据管理框架数据库中的统一数据对象OH_UdmfData数据进行数据更改。

起始版本： 20

参数：

|参数项|描述| |–|–| |OH_UdmfOptions* options|指向数据操作选项OH_UdmfOptions实例的指针。| |OH_UdmfData* unifiedData|指向统一数据对象OH_UdmfData实例的指针。|

返回：

OH_Udmf_DeleteUnifiedData()

int OH_Udmf_DeleteUnifiedData(OH_UdmfOptions* options, OH_UdmfData** dataArray, unsigned int* dataSize)

描述

删除统一数据管理框架数据库中的统一数据对象OH_UdmfData数据。

起始版本： 20

参数：

返回：

OH_Udmf_DestroyDataArray()

void OH_Udmf_DestroyDataArray(OH_UdmfData** dataArray, unsigned int dataSize)

描述

销毁数据数组内存。

起始版本： 20

参数：

|参数项|描述| |–|–| |OH_UdmfData** dataArray|指向统一数据对象OH_UdmfData的指针列表。| |unsigned int dataSize|列表中的数据大小。|

参考：

OH_UdmfData

OH_UdmfProgressInfo_GetProgress()

int OH_UdmfProgressInfo_GetProgress(OH_Udmf_ProgressInfo* progressInfo)

描述

从进度信息OH_Udmf_ProgressInfo中获取进度百分比数据。

起始版本： 15

参数：

|参数项|描述| |–|–| |OH_Udmf_ProgressInfo* progressInfo|表示进度信息OH_Udmf_ProgressInfo。|

返回：

|类型|说明| |–|–| |int|返回进度百分比数据。|

OH_UdmfProgressInfo_GetStatus()

int OH_UdmfProgressInfo_GetStatus(OH_Udmf_ProgressInfo* progressInfo)

描述

从进度信息OH_Udmf_ProgressInfo中获取状态信息。

起始版本： 15

参数：

|参数项|描述| |–|–| |OH_Udmf_ProgressInfo* progressInfo|表示进度信息OH_Udmf_ProgressInfo。|

返回：

|类型|说明| |–|–| |int|返回状态信息。|

OH_UdmfGetDataParams_Create()

OH_UdmfGetDataParams* OH_UdmfGetDataParams_Create()

描述

创建异步获取UDMF数据的请求参数OH_UdmfGetDataParams指针及实例对象。
当不再需要使用指针时，请使用OH_UdmfGetDataParams_Destroy销毁实例对象，否则会导致内存泄漏。

起始版本： 15

返回：

|类型|说明| |–|–| |OH_UdmfGetDataParams*|执行成功则返回一个指向属性OH_UdmfGetDataParams实例对象的指针，否则返回nullptr。|

OH_UdmfGetDataParams_Destroy()

void OH_UdmfGetDataParams_Destroy(OH_UdmfGetDataParams* pThis)

描述

销毁异步请求参数OH_UdmfGetDataParams指针指向的实例对象。

起始版本： 15

参数：

|参数项|描述| |–|–| |OH_UdmfGetDataParams* pThis|表示指向异步请求参数OH_UdmfGetDataParams实例的指针。|

OH_UdmfGetDataParams_SetDestUri()

void OH_UdmfGetDataParams_SetDestUri(OH_UdmfGetDataParams* params, const char* destUri)

描述

设置异步请求参数OH_UdmfGetDataParams中的目标路径。
若设置了目标路径，会将文件类型的数据进行拷贝到指定路径。回调中获取到的文件类型数据会被替换为目标路径的URI。
若不设置目标路径，则不会执行拷贝文件操作。回调中获取到的文件类型数据为源端路径URI。
若应用涉及复杂文件处理策略，或需要将文件拷贝在多个路径下时，建议不设置此参数，由应用自行完成文件拷贝相关处理。

起始版本： 15

参数：

|参数项|描述| |–|–| |OH_UdmfGetDataParams* params|表示指向异步请求参数OH_UdmfGetDataParams实例的指针。| |const char* destUri|表示目标路径地址。|

OH_UdmfGetDataParams_SetFileConflictOptions()

void OH_UdmfGetDataParams_SetFileConflictOptions(OH_UdmfGetDataParams* params, const Udmf_FileConflictOptions options)

描述

设置异步请求参数OH_UdmfGetDataParams中的文件冲突选项。

起始版本： 15

参数：

|参数项|描述| |–|–| |OH_UdmfGetDataParams* params|表示指向异步请求参数OH_UdmfGetDataParams实例的指针。| |const Udmf_FileConflictOptions options|表示文件拷贝冲突时的选项。|

OH_UdmfGetDataParams_SetProgressIndicator()

void OH_UdmfGetDataParams_SetProgressIndicator(OH_UdmfGetDataParams* params, const Udmf_ProgressIndicator progressIndicator)

描述

设置异步请求参数OH_UdmfGetDataParams中的进度条指示选项。

起始版本： 15

参数：

|参数项|描述| |–|–| |OH_UdmfGetDataParams* params|表示指向异步请求参数OH_UdmfGetDataParams实例的指针。| |const Udmf_ProgressIndicator progressIndicator|表示是否使用默认进度条选项。|

OH_UdmfGetDataParams_SetDataProgressListener()

void OH_UdmfGetDataParams_SetDataProgressListener(OH_UdmfGetDataParams* params, const OH_Udmf_DataProgressListener dataProgressListener)

描述

设置异步请求参数OH_UdmfGetDataParams中的监听回调函数。

起始版本： 15

参数：

|参数项|描述| |–|–| |OH_UdmfGetDataParams* params|表示指向异步请求参数OH_UdmfGetDataParams实例的指针。| |const OH_Udmf_DataProgressListener dataProgressListener|用户自定义的监听回调函数，可用于获取进度信息和数据。|

你可能感兴趣的鸿蒙文章

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/Q1FwM6