说明

以下仅介绍本模块特有错误码，通用错误码请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

## 1010710001 图片尺寸不符合要求

PC/2in1

**错误信息**

The size of the pixelmap exceeds the limit.

**错误描述**

调用添加图标等接口时，传入的图标图片尺寸不符合要求。

**可能原因**

未知原因

说明

当前图标尺寸不做严格限制。

**处理步骤**

请更换传入的图片数据或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1010710002 菜单项数量超出限制

PC/2in1

**错误信息**

The number of menu items or submenu items exceeds the limit.

**错误描述**

调用添加图标等接口时，传入的菜单项数量超出限制。

**可能原因**

* 传入的所有一级菜单项的数量超过限制上限20
* 传入的某个一级菜单项的子菜单项的数量超过上限20

**处理步骤**

请重新设置一级菜单项和二级菜单项或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1010710003 API调用频繁

PC/2in1

**错误信息**

The API is being called too frequently.

**错误描述**

指定API调用频繁。

**可能原因**

addToStatusBar，removeFromStatusBar，updateStatusBarIcon，updateQuickOperationHeight，updateStatusBarMenu等方法时调用间隔小于20ms。

**处理步骤**

请注意设置API的调用间隔或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1010710004 无前台窗口不允许移除图标

PC/2in1

**错误信息**

The icon cannot be deleted when no window is in the foreground.

**错误描述**

前台无应用窗口，不允许调用removeFromStatusBar移除状态栏图标。

**可能原因**

应用退后台后调用了removeFromStatusBar方法。

**处理步骤**

请注意API的调用时机或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1010710005 字符串长度超出阈值

PC/2in1

**错误信息**

The string length exceeds the threshold.

**错误描述**

字串长度超出限制范围。

**可能原因**

* [StatusBarItem](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/statusbar-extension-manager#statusbaritem)中配置的hoverTips字符串长度为0或者大于128。
* 调用[updateStatusBarHoverTips](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/statusbar-extension-manager#statusbarmanagerupdatestatusbarhovertips)方法时传入的字符串长度为0或者大于128。

**处理步骤**

检查传入字符串的长度是否在取值范围中，如果无法解决请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1010710006 菜单项不存在

PC/2in1

**错误信息**

Menu item not found.

**错误描述**

对不存在的菜单项进行更新。

**可能原因**

* 调用[updateStatusBarMenuItem](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/statusbar-extension-manager#statusbarmanagerupdatestatusbarmenuitem)时，若传入的item的menuCode未在状态栏的一级菜单项中预先定义，则会导致更新失败。
* 调用[updateStatusBarSubMenuItem](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/statusbar-extension-manager#statusbarmanagerupdatestatusbarsubmenuitem)时，若传入的item的menuCode未在状态栏的二级菜单项中预先定义，则会导致更新失败。

**处理步骤**

请检查待更新的一级或二级菜单项的menuCode是否与现有菜单项的menuCode一致，如果无法解决请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1010710007 菜单项的menuCode不唯一

PC/2in1

**错误信息**

The menuCode of the menu item is not unique.

**错误描述**

菜单项的menuCode不唯一。

**可能原因**

* 调用addToStatusBar时，菜单中的menuCode不唯一。
* 调用updateStatusBarMenu时，菜单中的menuCode不唯一。
* 调用updateStatusBarMenuItem时，待更新的item的子菜单的menuCode不唯一。
  + 子菜单的各menuCode在当前菜单项中不唯一。
  + 子菜单的menuCode是其他菜单项的menuCode。
  + 子菜单的menuCode在其他菜单项的子菜单中存在。

**处理步骤**

请确保所有菜单项的menuCode值保持唯一，合理配置各菜单项的menuCode值以避免冲突，如果无法解决请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1010720001 传入的一级菜单项数据不满足要求

PC/2in1

**错误信息**

A menu item contains neither submenu nor menuAction.

**错误描述**

调用添加图标、更新菜单等接口时，传入的一级菜单项数据不满足要求。

**可能原因**

当前传入的某个一级菜单项既不包含[menuAction](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/statusbar-extension-manager#statusbarmenuitem)，也不包含[subMenu](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/statusbar-extension-manager#statusbarmenuitem)。

**处理步骤**

请排查传入的一级菜单项的参数或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1020210001 菜单分组数量超过限制

PC/2in1

**错误信息**

Maximum number of categories reached.

**错误描述**

添加的分组数量超出限制。

**可能原因**

分组最大数量为3，添加的菜单分组数量超过了限制。

**处理步骤**

请重新设置菜单分组的数量或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1020210002 菜单分组名称重复

PC/2in1

**错误信息**

Duplicate category name.

**错误描述**

传入的分组名称和其他分组名称重复。

**可能原因**

调用添加分组和更新分组接口时，传入的分组名称和已存在的分组名称重复。

**处理步骤**

请重新设置菜单分组的名称或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1020210003 未找到菜单分组

PC/2in1

**错误信息**

Category not found.

**错误描述**

调用获取分组、更新分组、删除分组等接口时，未找到对应的菜单分组。

**可能原因**

* 没有添加菜单分组就去获取所有的菜单分组。
* 更新菜单分组时传入的分组Id有误，未找到对应的菜单分组。
* 删除菜单分组时传入的分组Id有误，未找到对应的菜单分组。
* 获取一个分组下的所有任务时传入的分组Id有误，未找到对应的菜单分组。
* 添加菜单任务时传入的分组Id有误，未找到对应的菜单分组。

**处理步骤**

请重新设置已存在的分组Id或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1020210004 未找到菜单任务

PC/2in1

**错误信息**

Quick task not found.

**错误描述**

调用获取任务、更新任务、删除任务等接口时，未找到对应的菜单任务。

**可能原因**

* 删除菜单任务时传入的任务Id有误，未找到对应的菜单任务。
* 获取一个分组下的所有任务时，获取的任务数量为0。
* 更新菜单任务时传入的任务Id有误，未找到对应的菜单任务。

**处理步骤**

请重新设置已存在的任务Id或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1020210005 分组已经存在错误信息

PC/2in1

**错误信息**

Group already exists.

**错误描述**

调用新增分组接口时，分组已经存在。

**可能原因**

分组已经增加过，不可重复增加。

**处理步骤**

请检查分组信息或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1020210006 分组未找到错误信息

PC/2in1

**错误信息**

Group not found.

**错误描述**

调用删除分组接口时，未找到对应分组。

**可能原因**

分组信息不存在。

**处理步骤**

请检查分组信息或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1020210007 窗口未找到错误信息

PC/2in1

**错误信息**

Window not found.

**错误描述**

窗口id不存在。

**可能原因**

窗口id有误。

**处理步骤**

请检查窗口id或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1020210008 字符串长度超出限制

PC/2in1

**错误信息**

The string length exceeds the threshold.

**错误描述**

传入的字符串参数的长度超过限制。

**可能原因**

* 调用[addCustomCategory](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/desktop-quickbar-extension-manager#quickbarmanageraddcustomcategory)方法时传入的字符串长度大于512或者内容为空。
* 调用[updateCustomCategory](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/desktop-quickbar-extension-manager#quickbarmanagerupdatecustomcategory)方法时传入的字符串长度大于512或者内容为空。
* 调用[addQuickTask](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/desktop-quickbar-extension-manager#quickbarmanageraddquicktask)方法时传入的字符串长度大于512或者内容为空。
* 调用[updateQuickTask](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/desktop-quickbar-extension-manager#quickbarmanagerupdatequicktask)方法时传入的字符串长度大于512或者内容为空。

**处理步骤**

请重新设置字符串的内容或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。

## 1020210009 无效的parameter

PC/2in1

**错误信息**

Invalid parameter.

**错误描述**

传入的parameters参数的数组大小超过限制。

**可能原因**

* 调用[addQuickTask](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/desktop-quickbar-extension-manager#quickbarmanageraddquicktask)方法时传入的parameters参数的数组大小超过64。
* 调用[updateQuickTask](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/desktop-quickbar-extension-manager#quickbarmanagerupdatequicktask)方法时传入的parameters参数的数组大小超过64。

**处理步骤**

请重新设置parameters参数的数组元素数量或通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题，华为支持人员会及时处理。