1# udmf.h 2 3 4## 概述 5 6提供访问统一数据管理框架数据的接口、数据结构、枚举类型。 7 8**引用文件：**<database/udmf/udmf.h> 9 10**库：** libudmf.so 11 12**系统能力：** SystemCapability.DistributedDataManager.UDMF.Core 13 14**起始版本：** 12 15 16**相关模块：**[UDMF](_u_d_m_f.md) 17 18 19## 汇总 20 21 22### 宏定义 23 24| 名称 | 描述 | 25| -------- | -------- | 26| [UDMF_KEY_BUFFER_LEN](_u_d_m_f.md#udmf_key_buffer_len) (512) | 统一数据对象唯一标识符最小空间长度。 | 27 28 29### 类型定义 30 31| 名称 | 描述 | 32| -------- | -------- | 33| typedef enum [Udmf_Intention](_u_d_m_f.md#udmf_intention) [Udmf_Intention](_u_d_m_f.md#udmf_intention) | 描述UDMF数据通路枚举类型。 | 34| typedef enum [Udmf_ShareOption](_u_d_m_f.md#udmf_shareoption) [Udmf_ShareOption](_u_d_m_f.md#udmf_shareoption) | UDMF支持的设备内使用范围类型枚举。 | 35| typedef enum [Udmf_FileConflictOptions](_u_d_m_f.md#udmf_fileconflictoptions) [Udmf_FileConflictOptions](_u_d_m_f.md#udmf_fileconflictoptions) | 定义文件拷贝冲突时的选项。 | 36| typedef enum [Udmf_ProgressIndicator](_u_d_m_f.md#udmf_progressindicator) [Udmf_ProgressIndicator](_u_d_m_f.md#udmf_progressindicator) | 定义进度条指示选项，可选择是否采用系统默认进度显示。 | 37| typedef struct [OH_UdmfData](_u_d_m_f.md#oh_udmfdata) [OH_UdmfData](_u_d_m_f.md#oh_udmfdata) | 定义统一数据对象数据结构。 | 38| typedef struct [OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) [OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) | 定义统一数据对象中记录数据的数据结构，称为数据记录。 | 39| typedef struct [OH_UdmfRecordProvider](_u_d_m_f.md#oh_udmfrecordprovider) [OH_UdmfRecordProvider](_u_d_m_f.md#oh_udmfrecordprovider) | 定义统一数据对象中的数据提供者。 | 40| typedef struct [OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) [OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) | 定义统一数据对象中数据记录的属性结构。 | 41| typedef struct [OH_Udmf_ProgressInfo](_u_d_m_f.md#oh_udmf_progressinfo) [OH_Udmf_ProgressInfo](_u_d_m_f.md#oh_udmf_progressinfo) | 定义进度信息的数据结构。 | 42| typedef struct [OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams) [OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams) | 定义异步获取UDMF数据的请求参数。 | 43| typedef void(\* [OH_Udmf_DataProgressListener](_u_d_m_f.md#oh_udmf_dataprogresslistener)) ([OH_Udmf_ProgressInfo](_u_d_m_f.md#oh_udmf_progressinfo) \*progressInfo, [OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*data) | 定义获取进度信息和数据的监听回调函数。<br/>使用时需要判断数据是否返回空指针。只有当进度达到100时，才会返回数据。 | 44| typedef void(\* [UdmfData_Finalize](_u_d_m_f.md#udmfdata_finalize)) (void \*context) | 定义用于释放上下文的回调函数，统一数据提供者对象销毁时触发。 | 45| typedef void \*(\* [OH_UdmfRecordProvider_GetData](_u_d_m_f.md#oh_udmfrecordprovider_getdata)) (void \*context, const char \*type) | 定义用于按类型获取数据的回调函数。 当从OH_UdmfRecord中获取数据时，会触发此回调函数，得到的数据就是这个回调函数返回的数据。 | 46 47 48### 枚举 49 50| 名称 | 描述 | 51| -------- | -------- | 52| [Udmf_Intention](_u_d_m_f.md#udmf_intention-1) { UDMF_INTENTION_DRAG, UDMF_INTENTION_PASTEBOARD } | 描述UDMF数据通路枚举类型。 | 53| [Udmf_ShareOption](_u_d_m_f.md#udmf_shareoption-1) { SHARE_OPTIONS_INVALID, SHARE_OPTIONS_IN_APP, SHARE_OPTIONS_CROSS_APP } | UDMF支持的设备内使用范围类型枚举。 | 54| [Udmf_FileConflictOptions](_u_d_m_f.md#udmf_fileconflictoptions-1) { UDMF_OVERWRITE = 0, UDMF_SKIP = 1 } | 定义文件拷贝冲突时的选项。 | 55| [Udmf_ProgressIndicator](_u_d_m_f.md#udmf_progressindicator-1) { UDMF_NONE = 0, UDMF_DEFAULT = 1 } | 定义进度条指示选项，可选择是否采用系统默认进度显示。 | 56 57 58### 函数 59 60| 名称 | 描述 | 61| -------- | -------- | 62| [OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \* [OH_UdmfData_Create](_u_d_m_f.md#oh_udmfdata_create) () | 创建统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)指针及实例对象。 当不再需要使用指针时，请使用[OH_UdmfData_Destroy](_u_d_m_f.md#oh_udmfdata_destroy)销毁实例对象，否则会导致内存泄漏。 | 63| void [OH_UdmfData_Destroy](_u_d_m_f.md#oh_udmfdata_destroy) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*pThis) | 销毁统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)指针指向的实例对象。 | 64| int [OH_UdmfData_AddRecord](_u_d_m_f.md#oh_udmfdata_addrecord) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*pThis, [OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*record) | 添加一个数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)到统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)中。 | 65| bool [OH_UdmfData_HasType](_u_d_m_f.md#oh_udmfdata_hastype) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*pThis, const char \*type) | 检查统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)中是否存在指定类型。 | 66| char \*\* [OH_UdmfData_GetTypes](_u_d_m_f.md#oh_udmfdata_gettypes) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*pThis, unsigned int \*count) | 获取统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)中包含的所有类型结果集。 | 67| [OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*\* [OH_UdmfData_GetRecords](_u_d_m_f.md#oh_udmfdata_getrecords) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*pThis, unsigned int \*count) | 获取统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)中包含的所有记录结果集。 | 68| [OH_UdmfRecordProvider](_u_d_m_f.md#oh_udmfrecordprovider) \* [OH_UdmfRecordProvider_Create](_u_d_m_f.md#oh_udmfrecordprovider_create) () | 创建一个统一数据提供者[OH_UdmfRecordProvider](_u_d_m_f.md#oh_udmfrecordprovider)指针及实例对象。 当不再需要使用指针时，请使用[OH_UdmfRecordProvider_Destroy](_u_d_m_f.md#oh_udmfrecordprovider_destroy)销毁实例对象，否则会导致内存泄漏。 | 69| int [OH_UdmfRecordProvider_Destroy](_u_d_m_f.md#oh_udmfrecordprovider_destroy) ([OH_UdmfRecordProvider](_u_d_m_f.md#oh_udmfrecordprovider) \*provider) | 销毁统一数据提供者[OH_UdmfRecordProvider](_u_d_m_f.md#oh_udmfrecordprovider)指针指向的实例对象。 | 70| int [OH_UdmfRecordProvider_SetData](_u_d_m_f.md#oh_udmfrecordprovider_setdata) ([OH_UdmfRecordProvider](_u_d_m_f.md#oh_udmfrecordprovider) \*provider, void \*context, const [OH_UdmfRecordProvider_GetData](_u_d_m_f.md#oh_udmfrecordprovider_getdata) callback, const [UdmfData_Finalize](_u_d_m_f.md#udmfdata_finalize) finalize) | 设置统一数据提供者的数据提供回调函数。 | 71| [OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \* [OH_UdmfRecord_Create](_u_d_m_f.md#oh_udmfrecord_create) () | 创建统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)指针及实例对象。 当不再需要使用指针时，请使用[OH_UdmfRecord_Destroy](_u_d_m_f.md#oh_udmfrecord_destroy)销毁实例对象，否则会导致内存泄漏。 | 72| void [OH_UdmfRecord_Destroy](_u_d_m_f.md#oh_udmfrecord_destroy) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis) | 销毁统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)指针指向的实例对象。 | 73| int [OH_UdmfRecord_AddGeneralEntry](_u_d_m_f.md#oh_udmfrecord_addgeneralentry) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, const char \*typeId, unsigned char \*entry, unsigned int count) | 添加用户自定义的通用数据至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 对于已定义UDS的类型（比如PlainText、Link、Pixelmap等）不可使用该接口。 | 74| int [OH_UdmfRecord_AddPlainText](_u_d_m_f.md#oh_udmfrecord_addplaintext) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsPlainText](_u_d_m_f.md#oh_udsplaintext) \*plainText) | 增加纯文本类型[OH_UdsPlainText](_u_d_m_f.md#oh_udsplaintext)数据至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 | 75| int [OH_UdmfRecord_AddHyperlink](_u_d_m_f.md#oh_udmfrecord_addhyperlink) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsHyperlink](_u_d_m_f.md#oh_udshyperlink) \*hyperlink) | 增加超链接类型[OH_UdsHyperlink](_u_d_m_f.md#oh_udshyperlink)数据至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 | 76| int [OH_UdmfRecord_AddHtml](_u_d_m_f.md#oh_udmfrecord_addhtml) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsHtml](_u_d_m_f.md#oh_udshtml) \*html) | 增加超文本标记语言类型[OH_UdsHtml](_u_d_m_f.md#oh_udshtml)数据至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 | 77| int [OH_UdmfRecord_AddAppItem](_u_d_m_f.md#oh_udmfrecord_addappitem) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsAppItem](_u_d_m_f.md#oh_udsappitem) \*appItem) | 增加桌面图标类型[OH_UdsAppItem](_u_d_m_f.md#oh_udsappitem)数据至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 | 78| int [OH_UdmfRecord_AddFileUri](_u_d_m_f.md#oh_udmfrecord_addfileuri) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsFileUri](_u_d_m_f.md#oh_udsfileuri) \*fileUri) | 增加文件Uri类型[OH_UdsFileUri](_u_d_m_f.md#oh_udsfileuri)数据至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 | 79| int [OH_UdmfRecord_AddPixelMap](_u_d_m_f.md#oh_udmfrecord_addpixelmap) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsPixelMap](_u_d_m_f.md#oh_udspixelmap) \*pixelMap) | 增加像素图片类型[OH_UdsPixelMap](_u_d_m_f.md#oh_udspixelmap)数据至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 | 80| int [OH_UdmfRecord_AddArrayBuffer](_u_d_m_f.md#oh_udmfrecord_addarraybuffer) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*record, const char \*type, [OH_UdsArrayBuffer](_u_d_m_f.md#oh_udsarraybuffer) \*buffer) | 增加一个ArrayBuffer类型[OH_UdsArrayBuffer](_u_d_m_f.md#oh_udsarraybuffer)的数据至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 | 81| int [OH_UdmfRecord_AddContentForm](_u_d_m_f.md#oh_udmfrecord_addcontentform) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsContentForm](_u_d_m_f.md#oh_udscontentform) \*contentForm) | 增加一个内容卡片类型[OH_UdsContentForm](_u_d_m_f.md#oh_udscontentform)的数据至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 | 82| char \*\* [OH_UdmfRecord_GetTypes](_u_d_m_f.md#oh_udmfrecord_gettypes) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, unsigned int \*count) | 获取统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中所有类型的结果集。 | 83| int [OH_UdmfRecord_GetGeneralEntry](_u_d_m_f.md#oh_udmfrecord_getgeneralentry) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, const char \*typeId, unsigned char \*\*entry, unsigned int \*count) | 获取统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中的特定类型的数据结果集。 | 84| int [OH_UdmfRecord_GetPlainText](_u_d_m_f.md#oh_udmfrecord_getplaintext) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsPlainText](_u_d_m_f.md#oh_udsplaintext) \*plainText) | 从统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中获取纯文本类型[OH_UdsPlainText](_u_d_m_f.md#oh_udsplaintext)数据。 | 85| int [OH_UdmfRecord_GetHyperlink](_u_d_m_f.md#oh_udmfrecord_gethyperlink) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsHyperlink](_u_d_m_f.md#oh_udshyperlink) \*hyperlink) | 从统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中获取超链接类型[OH_UdsHyperlink](_u_d_m_f.md#oh_udshyperlink)数据。 | 86| int [OH_UdmfRecord_GetHtml](_u_d_m_f.md#oh_udmfrecord_gethtml) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsHtml](_u_d_m_f.md#oh_udshtml) \*html) | 从统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中获取超文本标记语言类型[OH_UdsHtml](_u_d_m_f.md#oh_udshtml)数据。 | 87| int [OH_UdmfRecord_GetAppItem](_u_d_m_f.md#oh_udmfrecord_getappitem) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsAppItem](_u_d_m_f.md#oh_udsappitem) \*appItem) | 从统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中获取桌面图标类型[OH_UdsAppItem](_u_d_m_f.md#oh_udsappitem)数据。 | 88| int [OH_UdmfRecord_SetProvider](_u_d_m_f.md#oh_udmfrecord_setprovider) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, const char \*const \*types, unsigned int count, [OH_UdmfRecordProvider](_u_d_m_f.md#oh_udmfrecordprovider) \*provider) | 将指定类型的统一数据提供者[OH_UdmfRecordProvider](_u_d_m_f.md#oh_udmfrecordprovider)设置至统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中。 | 89| int [OH_UdmfRecord_GetFileUri](_u_d_m_f.md#oh_udmfrecord_getfileuri) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsFileUri](_u_d_m_f.md#oh_udsfileuri) \*fileUri) | 从统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中获取文件Uri类型[OH_UdsFileUri](_u_d_m_f.md#oh_udsfileuri)数据。 | 90| int [OH_UdmfRecord_GetPixelMap](_u_d_m_f.md#oh_udmfrecord_getpixelmap) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsPixelMap](_u_d_m_f.md#oh_udspixelmap) \*pixelMap) | 从统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中获取像素图片类型[OH_UdsPixelMap](_u_d_m_f.md#oh_udspixelmap)数据。 | 91| int [OH_UdmfRecord_GetArrayBuffer](_u_d_m_f.md#oh_udmfrecord_getarraybuffer) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*record, const char \*type, [OH_UdsArrayBuffer](_u_d_m_f.md#oh_udsarraybuffer) \*buffer) | 从统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中获取ArrayBuffer类型[OH_UdsArrayBuffer](_u_d_m_f.md#oh_udsarraybuffer)数据。 | 92| int [OH_UdmfRecord_GetContentForm](_u_d_m_f.md#oh_udmfrecord_getcontentform) ([OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \*pThis, [OH_UdsContentForm](_u_d_m_f.md#oh_udscontentform) \*contentForm) | 从统一数据记录[OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord)中获取内容卡片类型[OH_UdsContentForm](_u_d_m_f.md#oh_udscontentform)数据。 | 93| int [OH_UdmfData_GetPrimaryPlainText](_u_d_m_f.md#oh_udmfdata_getprimaryplaintext) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*data, [OH_UdsPlainText](_u_d_m_f.md#oh_udsplaintext) \*plainText) | 从统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)中获取第一个纯文本类型[OH_UdsPlainText](_u_d_m_f.md#oh_udsplaintext)数据。 | 94| int [OH_UdmfData_GetPrimaryHtml](_u_d_m_f.md#oh_udmfdata_getprimaryhtml) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*data, [OH_UdsHtml](_u_d_m_f.md#oh_udshtml) \*html) | 从统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)中获取第一个超文本标记语言类型[OH_UdsHtml](_u_d_m_f.md#oh_udshtml)数据。 | 95| int [OH_UdmfData_GetRecordCount](_u_d_m_f.md#oh_udmfdata_getrecordcount) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*data) | 获取统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)中包含的所有记录数量。 | 96| [OH_UdmfRecord](_u_d_m_f.md#oh_udmfrecord) \* [OH_UdmfData_GetRecord](_u_d_m_f.md#oh_udmfdata_getrecord) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*data, unsigned int index) | 获取统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)中指定位置的数据记录。 | 97| bool [OH_UdmfData_IsLocal](_u_d_m_f.md#oh_udmfdata_islocal) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*data) | 检查统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)是否是来自本端设备的数据。 | 98| [OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \* [OH_UdmfProperty_Create](_u_d_m_f.md#oh_udmfproperty_create) ([OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*unifiedData) | 创建统一数据对象中数据记录属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)指针及实例对象。 当不再需要使用指针时，请使用[OH_UdmfProperty_Destroy](_u_d_m_f.md#oh_udmfproperty_destroy)销毁实例对象，否则会导致内存泄漏。 | 99| void [OH_UdmfProperty_Destroy](_u_d_m_f.md#oh_udmfproperty_destroy) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis) | 销毁数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)指针指向的实例对象。 | 100| const char \* [OH_UdmfProperty_GetTag](_u_d_m_f.md#oh_udmfproperty_gettag) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis) | 从数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)中获取用户自定义标签值。 | 101| int64_t [OH_UdmfProperty_GetTimestamp](_u_d_m_f.md#oh_udmfproperty_gettimestamp) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis) | 从数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)中获取时间戳。 | 102| [Udmf_ShareOption](_u_d_m_f.md#udmf_shareoption) [OH_UdmfProperty_GetShareOption](_u_d_m_f.md#oh_udmfproperty_getshareoption) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis) | 从数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)中获取设备内适用范围属性。 | 103| int [OH_UdmfProperty_GetExtrasIntParam](_u_d_m_f.md#oh_udmfproperty_getextrasintparam) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis, const char \*key, int defaultValue) | 从数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)中获取自定义的附加整型参数。 | 104| const char \* [OH_UdmfProperty_GetExtrasStringParam](_u_d_m_f.md#oh_udmfproperty_getextrasstringparam) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis, const char \*key) | 从数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)中获取自定义的附加字符串参数。 | 105| int [OH_UdmfProperty_SetTag](_u_d_m_f.md#oh_udmfproperty_settag) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis, const char \*tag) | 设置数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)的自定义标签值。 | 106| int [OH_UdmfProperty_SetShareOption](_u_d_m_f.md#oh_udmfproperty_setshareoption) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis, [Udmf_ShareOption](_u_d_m_f.md#udmf_shareoption) option) | 设置数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)的设备内适用范围**OH_Udmf_ShareOption**参数。 | 107| int [OH_UdmfProperty_SetExtrasIntParam](_u_d_m_f.md#oh_udmfproperty_setextrasintparam) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis, const char \*key, int param) | 设置数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)的附加整型参数。 | 108| int [OH_UdmfProperty_SetExtrasStringParam](_u_d_m_f.md#oh_udmfproperty_setextrasstringparam) ([OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty) \*pThis, const char \*key, const char \*param) | 设置数据属性[OH_UdmfProperty](_u_d_m_f.md#oh_udmfproperty)的附加字符串参数。 | 109| int [OH_Udmf_GetUnifiedData](_u_d_m_f.md#oh_udmf_getunifieddata) (const char \*key, [Udmf_Intention](_u_d_m_f.md#udmf_intention) intention, [OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*unifiedData) | 从统一数据管理框架数据库中获取统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)数据。 | 110| int [OH_Udmf_SetUnifiedData](_u_d_m_f.md#oh_udmf_setunifieddata) ([Udmf_Intention](_u_d_m_f.md#udmf_intention) intention, [OH_UdmfData](_u_d_m_f.md#oh_udmfdata) \*unifiedData, char \*key, unsigned int keyLen) | 从统一数据管理框架数据库中写入统一数据对象[OH_UdmfData](_u_d_m_f.md#oh_udmfdata)数据。 | 111| int [OH_UdmfProgressInfo_GetProgress](_u_d_m_f.md#oh_udmfprogressinfo_getprogress) ([OH_Udmf_ProgressInfo](_u_d_m_f.md#oh_udmf_progressinfo) \*progressInfo) | 从进度信息[OH_Udmf_ProgressInfo](_u_d_m_f.md#oh_udmf_progressinfo)中获取进度百分比数据。 | 112| int [OH_UdmfProgressInfo_GetStatus](_u_d_m_f.md#oh_udmfprogressinfo_getstatus) ([OH_Udmf_ProgressInfo](_u_d_m_f.md#oh_udmf_progressinfo) \*progressInfo) | 从进度信息[OH_Udmf_ProgressInfo](_u_d_m_f.md#oh_udmf_progressinfo)中获取状态信息。 | 113| [OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams) \* [OH_UdmfGetDataParams_Create](_u_d_m_f.md#oh_udmfgetdataparams_create) () | 创建异步获取UDMF数据的请求参数[OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams)指针及实例对象。<br/>当不再需要使用指针时，请使用[OH_UdmfGetDataParams_Destroy](_u_d_m_f.md#oh_udmfgetdataparams_destroy)销毁实例对象，否则会导致内存泄漏。 | 114| void [OH_UdmfGetDataParams_Destroy](_u_d_m_f.md#oh_udmfgetdataparams_destroy) ([OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams) \*pThis) | 销毁异步请求参数[OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams)指针指向的实例对象。 | 115| void [OH_UdmfGetDataParams_SetDestUri](_u_d_m_f.md#oh_udmfgetdataparams_setdesturi) ([OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams) \*params, const char \*destUri) | 设置异步请求参数[OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams)中的目标路径。<br/>若设置了目标路径，会将文件类型的数据进行拷贝到指定路径。回调中获取到的文件类型数据会被替换为目标路径的URI。<br/>若不设置目标路径，则不会执行拷贝文件操作。回调中获取到的文件类型数据为源端路径URI。<br/>若应用涉及复杂文件处理策略，或需要将文件拷贝在多个路径下时，建议不设置此参数，由应用自行完成文件拷贝相关处理。 | 116| void [OH_UdmfGetDataParams_SetFileConflictOptions](_u_d_m_f.md#oh_udmfgetdataparams_setfileconflictoptions) ([OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams) \*params, const [Udmf_FileConflictOptions](_u_d_m_f.md#udmf_fileconflictoptions) options) | 设置异步请求参数[OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams)中的文件冲突选项。 | 117| void [OH_UdmfGetDataParams_SetProgressIndicator](_u_d_m_f.md#oh_udmfgetdataparams_setprogressindicator) ([OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams) \*params, const [Udmf_ProgressIndicator](_u_d_m_f.md#udmf_progressindicator) progressIndicator) | 设置异步请求参数[OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams)中的进度条指示选项。 | 118| void [OH_UdmfGetDataParams_SetDataProgressListener](_u_d_m_f.md#oh_udmfgetdataparams_setdataprogresslistener) ([OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams) \*params, const [OH_Udmf_DataProgressListener](_u_d_m_f.md#oh_udmf_dataprogresslistener) dataProgressListener) | 设置异步请求参数[OH_UdmfGetDataParams](_u_d_m_f.md#oh_udmfgetdataparams)中的监听回调函数。 | 119