## 概述

PhonePC/2in1TabletTVWearable

提供ArkTS侧的[FrameNode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-arkui-framenode)转换[NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h)的方式。

**引用文件：** <arkui/native\_node\_napi.h>

**库：** libace\_ndk.z.so

**系统能力：** SystemCapability.ArkUI.ArkUI.Full

**起始版本：** 12

**相关模块：** [ArkUI\_NativeModule](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule)

**相关示例：** [NativeNodeNapiSample](https://gitcode.com/HarmonyOS_Samples/guide-snippets/tree/master/ArkUISample/NativeNodeNapiSample)

## 汇总

PhonePC/2in1TabletTVWearable

### 函数

PhonePC/2in1TabletTVWearable

展开

| 名称 | 描述 |
| --- | --- |
| [int32\_t OH\_ArkUI\_GetNodeHandleFromNapiValue(napi\_env env, napi\_value frameNode, ArkUI\_NodeHandle\* handle)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnodehandlefromnapivalue) | 获取ArkTS侧创建的FrameNode节点对象映射到Native侧的ArkUI\_NodeHandle。 |
| [int32\_t OH\_ArkUI\_GetContextFromNapiValue(napi\_env env, napi\_value value, ArkUI\_ContextHandle\* context)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getcontextfromnapivalue) | 获取ArkTS侧创建的UIContext对象映射到Native侧的ArkUI\_ContextHandle。 |
| [int32\_t OH\_ArkUI\_GetNodeContentFromNapiValue(napi\_env env, napi\_value value, ArkUI\_NodeContentHandle\* content)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnodecontentfromnapivalue) | 获取ArkTS侧创建的NodeContent对象映射到Native侧的ArkUI\_NodeContentHandle。 |
| [int32\_t OH\_ArkUI\_GetDrawableDescriptorFromNapiValue(napi\_env env, napi\_value value, ArkUI\_DrawableDescriptor\*\* drawableDescriptor)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getdrawabledescriptorfromnapivalue) | 将ArkTS侧创建的DrawableDescriptor对象映射到Native侧的ArkUI\_DrawableDescriptor。 |
| [int32\_t OH\_ArkUI\_GetDrawableDescriptorFromResourceNapiValue(napi\_env env, napi\_value value, ArkUI\_DrawableDescriptor\*\* drawableDescriptor)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getdrawabledescriptorfromresourcenapivalue) | 将ArkTS侧通过$r()获取的资源对象转换为Native侧可使用的ArkUI\_DrawableDescriptor对象。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetNavigationId(ArkUI\_NodeHandle node, char\* buffer, int32\_t bufferSize, int32\_t\* writeLength)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnavigationid) | 获取当前节点所在的Navigation组件的ID。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetNavDestinationName(ArkUI\_NodeHandle node, char\* buffer, int32\_t bufferSize, int32\_t\* writeLength)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnavdestinationname) | 获取当前节点所在的NavDestination组件的名称。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetNavStackLength(ArkUI\_NodeHandle node, int32\_t\* length)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnavstacklength) | 获取当前节点所在的Navigation栈的长度。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetNavDestinationNameByIndex(ArkUI\_NodeHandle node, int32\_t index, char\* buffer, int32\_t bufferSize, int32\_t\* writeLength)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnavdestinationnamebyindex) | 根据给定索引值，获取当前节点所在的Navigation栈中对应位置的页面名称。索引值从0开始计数，0为栈底。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetNavDestinationId(ArkUI\_NodeHandle node, char\* buffer, int32\_t bufferSize, int32\_t\* writeLength)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnavdestinationid) | 获取当前节点所在的NavDestination组件的ID。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetNavDestinationState(ArkUI\_NodeHandle node, ArkUI\_NavDestinationState\* state)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnavdestinationstate) | 获取当前节点所在的NavDestination组件的状态。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetNavDestinationIndex(ArkUI\_NodeHandle node, int32\_t\* index)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnavdestinationindex) | 获取当前节点所在的NavDestination组件在页面栈的索引。 |
| [napi\_value OH\_ArkUI\_GetNavDestinationParam(ArkUI\_NodeHandle node)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getnavdestinationparam) | 获取当前节点所在的NavDestination组件的参数。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetRouterPageIndex(ArkUI\_NodeHandle node, int32\_t\* index)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getrouterpageindex) | 获取当前节点所在页面在Router页面栈中的索引。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetRouterPageName(ArkUI\_NodeHandle node, char\* buffer, int32\_t bufferSize, int32\_t\* writeLength)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getrouterpagename) | 获取当前节点所在页面的名称。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetRouterPagePath(ArkUI\_NodeHandle node, char\* buffer, int32\_t bufferSize, int32\_t\* writeLength)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getrouterpagepath) | 获取当前节点所在页面的Page组件的路径。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetRouterPageState(ArkUI\_NodeHandle node, ArkUI\_RouterPageState\* state)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getrouterpagestate) | 获取当前节点所在页面的Page组件的状态。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_GetRouterPageId(ArkUI\_NodeHandle node, char\* buffer, int32\_t bufferSize, int32\_t\* writeLength)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_getrouterpageid) | 获取当前节点所在页面的Page组件的ID。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_InitModuleForArkTSEnv(napi\_env env)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_initmoduleforarktsenv) | 初始化指定上下文环境的ArkUI相关接口。该函数禁止在非UI线程中调用，否则程序将主动abort。 |
| [void OH\_ArkUI\_NotifyArkTSEnvDestroy(napi\_env env)](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_notifyarktsenvdestroy) | 通知指定的上下文环境已销毁。该函数禁止在非UI线程中调用，否则程序将主动abort。 |
| [int32\_t OH\_ArkUI\_PostFrameCallback(ArkUI\_ContextHandle uiContext, void\* userData,void (\*callback)(uint64\_t nanoTimestamp, uint32\_t frameCount, void\* userData))](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_postframecallback) | 注册一个回调函数，以便在下一帧渲染时执行。不允许在非UI线程调用，检查到非UI线程调用程序会主动中止。 |
| [int32\_t OH\_ArkUI\_PostIdleCallback(ArkUI\_ContextHandle uiContext, void\* userData,void (\*callback)(uint64\_t nanoTimeLeft, uint32\_t frameCount, void\* userData))](/consumer/cn/doc/harmonyos-references/capi-native-node-napi-h#oh_arkui_postidlecallback) | 注册一个回调函数，在下一帧渲染结束后如果距离下一个Vsync信号到来剩余时间大于1ms时，该回调函数将被执行；如果剩余时间小于1ms时，回调函数将被顺延至当某个下一帧的剩余时间大于1ms时再执行。如果当前没有下一帧，将自动请求下一帧。 |

## 函数说明

PhonePC/2in1TabletTVWearable

### OH\_ArkUI\_GetNodeHandleFromNapiValue()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetNodeHandleFromNapiValue(napi_env env, napi_value frameNode, ArkUI_NodeHandle* handle)
```

**描述：**

获取ArkTS侧创建的FrameNode节点对象映射到Native侧的ArkUI\_NodeHandle。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| napi\_env env | napi的环境指针。 |
| napi\_value frameNode | ArkTS侧创建的FrameNode对象。 |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h)\* handle | ArkUI\_NodeHandle指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。 |

### OH\_ArkUI\_GetContextFromNapiValue()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetContextFromNapiValue(napi_env env, napi_value value, ArkUI_ContextHandle* context)
```

**描述：**

获取ArkTS侧创建的[UIContext](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-uicontext)对象映射到Native侧的ArkUI\_ContextHandle。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| napi\_env env | napi的环境指针。 |
| napi\_value value | ArkTS侧创建的context对象。 |
| [ArkUI\_ContextHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-context8h)\* context | ArkUI\_ContextHandle指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。 |

### OH\_ArkUI\_GetNodeContentFromNapiValue()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetNodeContentFromNapiValue(napi_env env, napi_value value, ArkUI_NodeContentHandle* content)
```

**描述：**

获取ArkTS侧创建的NodeContent对象映射到Native侧的ArkUI\_NodeContentHandle。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| napi\_env env | napi的环境指针。 |
| napi\_value value | ArkTS侧创建的NodeContent对象。 |
| [ArkUI\_NodeContentHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-nodecontent8h)\* content | ArkUI\_NodeContentHandle指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。 |

### OH\_ArkUI\_GetDrawableDescriptorFromNapiValue()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetDrawableDescriptorFromNapiValue(napi_env env, napi_value value, ArkUI_DrawableDescriptor** drawableDescriptor)
```

**描述：**

将ArkTS侧创建的[DrawableDescriptor](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-image#drawabledescriptor10)对象映射到Native侧的[ArkUI\_DrawableDescriptor](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-drawabledescriptor)。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| napi\_env env | napi的环境指针。 |
| napi\_value value | ArkTS侧创建的[DrawableDescriptor](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-image#drawabledescriptor10)对象。 |
| [ArkUI\_DrawableDescriptor](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-drawabledescriptor)\*\* drawableDescriptor | 接受ArkUI\_DrawableDescriptor指针的对象。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。 |

### OH\_ArkUI\_GetDrawableDescriptorFromResourceNapiValue()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue(napi_env env, napi_value value, ArkUI_DrawableDescriptor** drawableDescriptor)
```

**描述：**

将ArkTS侧通过$r()获取的资源对象转换为Native侧可使用的[ArkUI\_DrawableDescriptor](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-drawabledescriptor)对象。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| napi\_env env | napi的环境指针。 |
| napi\_value value | ArkTS侧创建的$r资源对象。 |
| [ArkUI\_DrawableDescriptor](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-drawabledescriptor)\*\* drawableDescriptor | 接受ArkUI\_DrawableDescriptor指针的对象。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。 |

### OH\_ArkUI\_GetNavigationId()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetNavigationId(ArkUI_NodeHandle node, char* buffer, int32_t bufferSize, int32_t* writeLength)
```

**描述：**

获取当前节点所在的[Navigation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-navigation)组件的ID。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| char\* buffer | 缓冲区，NavigationID写入该内存区域。 |
| int32\_t bufferSize | 缓冲区大小。 |
| int32\_t\* writeLength | 在返回[ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示实际写入到缓冲区的字符串长度。 在返回[ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示可以容纳目标的最小缓冲区大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败，可能因为当前节点不在Navigation中。  [ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 数据大小超过指定的缓冲区大小。 |

### OH\_ArkUI\_GetNavDestinationName()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetNavDestinationName(ArkUI_NodeHandle node, char* buffer, int32_t bufferSize, int32_t* writeLength)
```

**描述：**

获取当前节点所在的[NavDestination](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-navdestination)组件的名称。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| char\* buffer | 缓冲区，被查询的NavDestination名称写入该内存区域。 |
| int32\_t bufferSize | 缓冲区大小。 |
| int32\_t\* writeLength | 在返回[ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示实际写入到缓冲区的字符串长度。 在返回[ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示可以容纳目标的最小缓冲区大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败，可能因为当前节点不在Navigation中。  [ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 给定的buffer size小于可以容纳目标的最小缓冲区大小。 |

### OH\_ArkUI\_GetNavStackLength()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetNavStackLength(ArkUI_NodeHandle node, int32_t* length)
```

**描述：**

获取当前节点所在的Navigation栈的长度。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| int32\_t\* length | 栈的长度。查询成功后将结果写回该参数。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败，可能因为当前节点不在Navigation中。 |

### OH\_ArkUI\_GetNavDestinationNameByIndex()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetNavDestinationNameByIndex(ArkUI_NodeHandle node, int32_t index, char* buffer, int32_t bufferSize, int32_t* writeLength)
```

**描述：**

根据给定索引值，获取当前节点所在的Navigation栈中的页面名称。索引值从0开始计数，0为栈底。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| int32\_t index | 被查询NavDestination在栈中的索引。 |
| char\* buffer | 缓冲区，被查询页面的名称写入该内存区域。 |
| int32\_t bufferSize | 缓冲区大小。 |
| int32\_t\* writeLength | 在返回[ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示实际写入到缓冲区的字符串长度。 在返回[ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示可以容纳目标的最小缓冲区大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_NODE\_INDEX\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) index为非法值。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败，可能因为当前节点不在Navigation中。  [ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 给定的buffer size小于可以容纳目标的最小缓冲区大小。 |

### OH\_ArkUI\_GetNavDestinationId()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetNavDestinationId(ArkUI_NodeHandle node, char* buffer, int32_t bufferSize, int32_t* writeLength)
```

**描述：**

获取当前节点所在的NavDestination组件的ID。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| char\* buffer | 缓冲区，NavDestinationID写入该内存区域。 |
| int32\_t bufferSize | 缓冲区大小。 |
| int32\_t\* writeLength | 在返回[ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示实际写入到缓冲区的字符串长度。 在返回[ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示可以容纳目标的最小缓冲区大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败，可能因为当前节点不在Navigation中。  [ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 数据大小超过指定的缓冲区大小。 |

### OH\_ArkUI\_GetNavDestinationState()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetNavDestinationState(ArkUI_NodeHandle node, ArkUI_NavDestinationState* state)
```

**描述：**

获取当前节点所在的NavDestination组件的状态。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| [ArkUI\_NavDestinationState](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_navdestinationstate)\* state | NavDestination的状态值写回该参数中。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败，可能因为当前节点不在Navigation中。 |

### OH\_ArkUI\_GetNavDestinationIndex()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetNavDestinationIndex(ArkUI_NodeHandle node, int32_t* index)
```

**描述：**

获取当前节点所在的NavDestination组件在页面栈的索引。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| int32\_t\* index | 索引值，从0开始计数。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败，可能因为当前节点不在Navigation中。 |

### OH\_ArkUI\_GetNavDestinationParam()

PhonePC/2in1TabletTVWearable



```
1. napi_value OH_ArkUI_GetNavDestinationParam(ArkUI_NodeHandle node)
```

**描述：**

获取当前节点所在的NavDestination组件的参数。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| napi\_value | 参数对象。如返回为空，则说明参数不存在或指定的节点为空。 |

### OH\_ArkUI\_GetRouterPageIndex()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetRouterPageIndex(ArkUI_NodeHandle node, int32_t* index)
```

**描述：**

获取当前节点所在[Router](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-router)页面栈中的索引。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| int32\_t\* index | 索引值，从1开始计数。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 指定的节点或传递的索引异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败，可能因为当前节点不在Navigation中。 |

### OH\_ArkUI\_GetRouterPageName()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetRouterPageName(ArkUI_NodeHandle node, char* buffer, int32_t bufferSize, int32_t* writeLength)
```

**描述：**

获取当前节点所在Router页面的名称。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| char\* buffer | 缓冲区，页面名称写入该内存区域。 |
| int32\_t bufferSize | 缓冲区大小。 |
| int32\_t\* writeLength | 在返回[ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示实际写入到缓冲区的字符串长度。 在返回[ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示可以容纳目标的最小缓冲区大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败。  [ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 给定的buffer size小于可以容纳目标的最小缓冲区大小。 |

### OH\_ArkUI\_GetRouterPagePath()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetRouterPagePath(ArkUI_NodeHandle node, char* buffer, int32_t bufferSize, int32_t* writeLength)
```

**描述：**

获取当前节点所在Router页面的路径。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| char\* buffer | 缓冲区，页面路径写入该内存区域。 |
| int32\_t bufferSize | 缓冲区大小。 |
| int32\_t\* writeLength | 在返回[ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示实际写入到缓冲区的字符串长度。 在返回[ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示可以容纳目标的最小缓冲区大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败。  [ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 给定的buffer size小于可以容纳目标的最小缓冲区大小。 |

### OH\_ArkUI\_GetRouterPageState()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetRouterPageState(ArkUI_NodeHandle node, ArkUI_RouterPageState* state)
```

**描述：**

获取当前节点所在Router页面的状态。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| [ArkUI\_RouterPageState](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_routerpagestate)\* state | Router页面的状态值写回该参数中。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败。 |

### OH\_ArkUI\_GetRouterPageId()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_GetRouterPageId(ArkUI_NodeHandle node, char* buffer, int32_t bufferSize, int32_t* writeLength)
```

**描述：**

获取当前节点所在Router页面的ID。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 指定的节点。 |
| char\* buffer | 缓冲区，页面Id写入该内存区域。 |
| int32\_t bufferSize | 缓冲区大小。 |
| int32\_t\* writeLength | 在返回[ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示实际写入到缓冲区的字符串长度。 在返回[ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode)时表示可以容纳目标的最小缓冲区大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 函数参数异常。  [ARKUI\_ERROR\_CODE\_GET\_INFO\_FAILED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 查询信息失败。  [ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 数据大小超过指定的缓冲区大小。 |

### OH\_ArkUI\_InitModuleForArkTSEnv()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_InitModuleForArkTSEnv(napi_env env)
```

**描述：**

初始化指定上下文环境的ArkUI相关接口。该函数禁止在非UI线程中调用，否则程序将主动abort。

**起始版本：** 20

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| napi\_env env | Node-API的环境指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数无效（如env为null或设置白名单失败）。  [ARKUI\_ERROR\_CODE\_CAPI\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) CAPI初始化错误。 |

### OH\_ArkUI\_NotifyArkTSEnvDestroy()

PhonePC/2in1TabletTVWearable



```
1. void OH_ArkUI_NotifyArkTSEnvDestroy(napi_env env)
```

**描述：**

通知指定的上下文环境已销毁。该函数禁止在非UI线程中调用，否则程序将主动abort。

**起始版本：** 20

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| napi\_env env | Node-API的环境指针。 |

### OH\_ArkUI\_PostFrameCallback()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_PostFrameCallback(ArkUI_ContextHandle uiContext, void* userData,void (*callback)(uint64_t nanoTimestamp, uint32_t frameCount, void* userData))
```

**描述：**

注册一个回调函数，以便在下一帧渲染时执行。不允许在非UI线程调用，检查到非UI线程调用程序会主动中止。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_ContextHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-context8h) uiContext | [UIContext](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-custom-component-api#uicontext)对象指针，用以绑定实例。 |
| void\* userData | 自定义事件参数，当事件触发时在回调参数中携带回来。 |
| callback | 自定义回调函数。 |
| uint64\_t nanoTimestamp | 帧信号的时间戳。 |
| uint32\_t frameCount | 帧号。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_CAPI\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) CAPI初始化错误。  [ARKUI\_ERROR\_CODE\_UI\_CONTEXT\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) uiContext对象无效。  [ARKUI\_ERROR\_CODE\_CALLBACK\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 回调函数无效。 |

### OH\_ArkUI\_PostIdleCallback()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_PostIdleCallback(ArkUI_ContextHandle uiContext, void* userData,void (*callback)(uint64_t nanoTimeLeft, uint32_t frameCount, void* userData))
```

**描述：**

注册一个回调函数，在下一帧渲染结束后如果距离下一帧到来剩余时间大于1ms时，该回调函数将被执行；如果剩余时间小于1ms时，回调函数将被顺延至当某个下一帧的剩余时间大于1ms时再执行。如果当前没有下一帧，将自动请求下一帧。

**起始版本：** 20

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_ContextHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-context8h) uiContext | UIContext对象，用以绑定实例。 |
| void\* userData | 自定义事件参数，当自定义回调函数触发时在回调参数中携带回来。 |
| callback | 自定义回调函数，会在下一帧事件结束后剩余时间大于1ms时回调执行。 |
| uint64\_t nanoTimeLeft | 下一帧渲染后的剩余时间。 |
| uint32\_t frameCount | 帧号。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_CAPI\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) CAPI初始化错误。  [ARKUI\_ERROR\_CODE\_UI\_CONTEXT\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) uiContext对象无效。  [ARKUI\_ERROR\_CODE\_CALLBACK\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 回调函数无效。 |