harmony 鸿蒙drawing_error_code.h

2025-06-12
浏览 (2)

drawing_error_code.h

概述

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

引用文件：

库： libnative_drawing.so

起始版本： 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_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