# drawing_error_code.h

#### 概述

声明与绘图模块中的错误码相关的函数。

**引用文件：** <native\_drawing/drawing\_error\_code.h>

**库：** libnative\_drawing.so

**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing

**起始版本：** 12

**相关模块：** Drawing

#### 汇总

#### 枚举

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| OH_Drawing_ErrorCode | OH_Drawing_ErrorCode | 枚举本模块可能产生的错误码。 |

#### 函数

| 名称 | 描述 |
| --- | --- |
| OH_Drawing_ErrorCode OH_Drawing_ErrorCodeGet() | 获取本模块的错误码。 |
| void OH_Drawing_ErrorCodeReset(void) | 将本模块的错误码重置为OH_DRAWING_SUCCESS。 通过OH_Drawing_ErrorCodeGet获取的本模块错误码会在不以错误码为返回值的接口执行失败时被置为对应的错误编号，但是不会在执行成功后被重置为OH_DRAWING_SUCCESS。 调用本接口可将错误码重置为OH_DRAWING_SUCCESS，避免多个接口间互相干扰，方便开发者调试。 |

#### 枚举类型说明

#### OH\_Drawing\_ErrorCode

```
enum OH_Drawing_ErrorCode
```

**描述**

枚举本模块可能产生的错误码。

**起始版本：** 12

| 枚举项 | 描述 |
| --- | --- |
| OH_DRAWING_SUCCESS = 0 | 操作成功完成。 |
| OH_DRAWING_ERROR_NO_PERMISSION = 201 | 权限校验失败。 |
| OH_DRAWING_ERROR_INVALID_PARAMETER = 401 | 无效的输入参数，如参数中传入了NULL。 |
| OH_DRAWING_ERROR_PARAMETER_OUT_OF_RANGE = 26200001 | 输入参数不在有效的范围内。 |
| OH_DRAWING_ERROR_ALLOCATION_FAILED = 26200002 | 内存分配失败。 起始版本： 13 |
| OH_DRAWING_ERROR_ATTRIBUTE_ID_MISMATCH = 26200003 | 输入属性id无匹配的函数。 起始版本： 21 |
| OH_DRAWING_ERROR_INCORRECT_PARAMETER = 26200004 | 输入参数不正确，例如入参的指针为空。 起始版本： 22 |
| OH_DRAWING_ERROR_FILE_NOT_FOUND = 26200005 | 文件未找到，指定的文件不存在或路径不正确。 起始版本： 23 |
| OH_DRAWING_ERROR_OPEN_FILE_FAILED = 26200006 | 打开文件失败，权限不足或I/O问题造成。 起始版本： 23 |
| OH_DRAWING_ERROR_FILE_SEEK_FAILED = 26200007 | 文件定位失败。系统无法重新定位文件读取指针。 起始版本： 23 |
| OH_DRAWING_ERROR_GET_FILE_SIZE_FAILED = 26200008 | 获取文件大小失败，系统无法获取文件大小信息。 起始版本： 23 |
| OH_DRAWING_ERROR_READ_FILE_FAILED = 26200009 | 读取文件失败，文件无法完整读取或包含不可读数据。 起始版本： 23 |
| OH_DRAWING_ERROR_EMPTY_FILE = 26200010 | 文件为空，指定的字体文件为空，不包含有效数据。 起始版本： 23 |
| OH_DRAWING_ERROR_FILE_CORRUPTED = 26200011 | 文件损坏，文件内容无效或损坏，无法解析。 起始版本： 23 |

#### 函数说明

#### OH\_Drawing\_ErrorCodeGet()

```
OH_Drawing_ErrorCode OH_Drawing_ErrorCodeGet()
```

**描述**

获取本模块的错误码。

**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing

**起始版本：** 12

**返回：**

| 类型 | 说明 |
| --- | --- |
| OH_Drawing_ErrorCode | 获取本模块的最近一次的错误码。当函数成功运行后，本函数返回的错误码不会被修改。 |

#### OH\_Drawing\_ErrorCodeReset()

```
void OH_Drawing_ErrorCodeReset(void)
```

**描述**

将本模块的错误码重置为OH\_DRAWING\_SUCCESS。

通过OH\_Drawing\_ErrorCodeGet获取的本模块错误码会在不以错误码为返回值的接口执行失败时被置为对应的错误编号，但是不会在执行成功后被重置为OH\_DRAWING\_SUCCESS。

调用本接口可将错误码重置为OH\_DRAWING\_SUCCESS，避免多个接口间互相干扰，方便开发者调试。

**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing

**起始版本：** 18