# OH_PictureMetadata

```
typedef struct OH_PictureMetadata OH_PictureMetadata
```

#### 概述

OH\_PictureMetadata用于承载Picture元数据。

有多种方式创建和获取OH\_PictureMetadata：

| 函数 | 描述 |
| --- | --- |
| OH_PictureMetadata_Create() | 创建OH_PictureMetadata指针。 |
| OH_PictureMetadata_Clone() | 拷贝元数据。 |
| OH_PictureNative_GetMetadata() | 获取主图的元数据。 |
| OH_AuxiliaryPictureNative_GetMetadata() | 获取辅助图的元数据。 |

使用OH\_PictureMetadata\_Release()函数释放OH\_PictureMetadata对象。

资源管理：通过OH\_PictureMetadata\_Create()、OH\_PictureMetadata\_Clone()、OH\_PictureNative\_GetMetadata()或OH\_AuxiliaryPictureNative\_GetMetadata()获取到的OH\_PictureMetadata对象由调用方管理，使用完成后应调用OH\_PictureMetadata\_Release()释放。通过OH\_PictureNative\_SetMetadata()或OH\_AuxiliaryPictureNative\_SetMetadata()设置元数据时，接口不会释放传入的OH\_PictureMetadata对象。

OH\_PictureMetadata结构体内容和操作方式如下：

| 字段类型 | 字段名称 | 字段描述 | 字段获取函数 | 字段设置函数 |
| --- | --- | --- | --- | --- |
| Image_String | property | 元数据属性。 | OH_PictureMetadata_GetProperty()、OH_PictureMetadata_GetPropertyWithNull() | OH_PictureMetadata_SetProperty() |
| OH_PictureMetadata | metadata | 元数据对象副本。 | OH_PictureMetadata_Clone() | - |

**起始版本：** 13

**相关模块：** Image\_NativeModule

**所在头文件：** image\_common.h