---
title: Serialize
description: "将图像内存数据及元数据序列化后落盘保存为文件。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/msadg/mxvisionug_0723.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/msadg/mxvisionug_0723.html
indexId: 3f11bc02562aa850c9232c64ea8dd640bd31ee996d2fee271698b9d8080b0c35102
---
# Serialize

#### 函数功能

将图像内存数据及元数据序列化后落盘保存为文件。


#### 函数原型

```
APP_ERROR Serialize(const std::string& filePath, bool forceOverwrite = false);
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| filePath | 输入 | 序列化后的数据文件保存路径（包括文件名称），不支持软链接。 |
| forceOverwrite | 输入 | 保存时是否强制覆盖已有文件，默认为“false”，不覆盖。 |


#### 返回参数说明

| 数据结构 | 说明 |
| --- | --- |
| APP\_ERROR | 程序执行返回的错误码，请参考APP\_ERROR说明。 |