1# 访问控制错误码 2 3<!--Kit: Ability Kit--> 4<!--Subsystem: Security--> 5<!--Owner: @xia-bubai--> 6<!--Designer: @linshuqing; @hehehe-li--> 7<!--Tester: @leiyuqian--> 8<!--Adviser: @zengyawen--> 9 10> **说明:** 11> 12> 以下仅介绍本模块特有错误码,通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 13 14## 12100001 入参错误 15 16**错误信息** 17 18Invalid Parameter. Error message: messageInfo. 19 20**错误描述** 21 22当入参错误时,将返回该错误码。 23 24**可能原因** 25 261. tokenId值为0。 272. 指定的权限名为空或者权限名长度大于256。 283. 请求授权/撤销权限的flag取值非法。 294. 注册监听的参数检查错误。 305. 指定的Context不属于当前应用。 316. 请求的权限不属于同一个权限组。 327. 请求的权限中存在应用未声明的权限。 338. 请求的全局开关类型非法。 349. 指定的权限名不是[user_grant权限](../../security/AccessToken/permissions-for-all-user.md)。 3510. 指定的数组成员个数超过1024或成员均为无效值。 3611. 请求查看权限使用记录的起始结束时间不合法。 3712. 指定的权限名未在应用中声明。 38 39**处理步骤** 40 41检查入参,修正参数值为有效值,有效值请参考各[接口参数说明](js-apis-abilityAccessCtrl.md)。 42 43<!--Del--> 44## 12100002 tokenId不存在 45 46**错误信息** 47 48TokenId does not exist. 49 50**错误描述** 51 52当指定的tokenId不符合条件时,将返回该错误码。 53 54**可能原因** 55 561. 指定的tokenId不存在。 572. 指定的tokenId对应的进程非应用进程。 58 59**处理步骤** 60 61检查入参,确认tokenId值是否为目标应用的身份标识。 62 63<!--Del--> 64## 12100003 权限名不存在 65 66**错误信息** 67 68Permission does not exist. 69 70**错误描述** 71 72当指定的权限名不符合条件时,将返回该错误码。 73 74**可能原因** 75 761. 系统中不存在指定的权限,包括权限未定义、权限类型不匹配。 772. 请求授权/撤销权限场景下,指定的应用tokenId未申请过指定的权限名。 783. 权限使用记录场景下,指定的权限名非用户授权的敏感权限。 79 80**处理步骤** 81 82检查入参,修正参数值为有效值,有效值请参考[权限列表](../../security/AccessToken/app-permissions.md)。 83<!--DelEnd--> 84 85## 12100004 接口未配套使用 86 87**错误信息** 88 89The API is not used in pair with others. 90 91**错误描述** 92 93当接口未配套使用时,将返回该错误码。 94 95**可能原因** 96 971. 当前接口在未配套使用的情况下,重复调用。 982. 当前接口在未配套使用的情况下,单独调用。 99 100**处理步骤** 101 1021. 检查当前接口是否有配套使用,如调用启动记录的接口后,在未调用停止记录的接口前,不可再次使用相同的入参调用启动记录接口。 1032. 检查当前接口是否有配套使用,如停止记录的接口需要在启动记录的接口调用之后方可调用,注销监听接口需要在注册监听接口调用之后方可调用。 104 105 106## 12100005 监听器数量超过限制 107 108**错误信息** 109 110The number of listeners exceeds the limit. 111 112**错误描述** 113 114当监听器数量超过限制时,将返回该错误码。 115 116**可能原因** 117 118该错误码表示当前监听器数量超过限制200个。 119 120**处理步骤** 121 122及时释放已注册的无用的监听器。 123 124<!--Del--> 125## 12100006 指定的应用不支持被授予或被取消授予指定的权限 126 127**错误信息** 128 129The specified application does not support the permissions granted or ungranted as specified. 130 131**错误描述** 132 133当指定的应用不支持被授予或被取消授予指定的权限时,将返回该错误码。 134 135**可能原因** 136 1371. 输入的tokenId是远端设备的身份标识,尚未支持分布式授权和取消授权。 1382. 入参指定的tokenId为沙箱应用,被禁止申请指定的权限。 139 140**处理步骤** 141 1421. 请确认tokenId的获取方式是否正确。 1432. 确认待授权的沙箱应用是否为特殊的受限沙箱应用进程,部分模式下的沙箱应用被禁止授予大部分权限。 144<!--DelEnd--> 145 146## 12100007 系统服务工作异常 147 148**错误信息** 149 150The service is abnormal. 151 152**错误描述** 153 154当系统服务工作异常时,将返回该错误码。 155 156**可能原因** 157 1581. 权限管理服务无法正常启动。 1592. IPC数据读取写入失败。 160 161**处理步骤** 162 163系统服务内部工作异常,请稍后重试,或者重启设备。 164 165<!--Del--> 166## 12100008 内存申请失败 167 168**错误信息** 169 170Out of memory. 171 172**错误描述** 173 174当内存申请失败时,将返回该错误码。 175 176**可能原因** 177 178系统内存不足。 179 180**处理步骤** 181 182系统内存不足,请稍后重试,或者重启设备。 183<!--DelEnd--> 184 185## 12100009 服务内部错误 186 187**错误信息** 188 189Common inner error. 190 191**错误描述** 192 193当服务内部错误时,将返回该错误码。 194 195**可能原因** 196 197系统服务内部错误。 198 199**处理步骤** 200 201系统内部逻辑错误,需要结合故障日志进一步分析。 202 203## 12100010 存在未被处理的请求 204 205**错误信息** 206 207The request already exists. 208 209**错误描述** 210 211当存在未被处理的请求时,将返回该错误码。 212 213**可能原因** 214 215上一次请求未被处理。 216 217**处理步骤** 218 219请处理完上次请求。 220 221 222## 12100011 输入的所有权限均已被授权 223 224**错误信息** 225 226All permissions in the permission list have been granted. 227 228**错误描述** 229 230当输入的所有权限均已被授权时,将返回该错误码。 231 232**可能原因** 233 234所有权限均已被授权。 235 236**处理步骤** 237 238无需处理,返回此错误码表示申请权限已被授权,不会拉起权限设置弹框。 239 240## 12100012 输入的权限中存在未被用户拒绝过的权限 241 242**错误信息** 243 244The permission list contains the permission that has not been revoked by the user. 245 246**错误描述** 247 248当输入的权限中存在未被用户拒绝过的权限时,将返回该错误码。 249 250**可能原因** 251 252存在未被用户拒绝过的权限。 253 254**处理步骤** 255 256请先调用requestPermissionsFromUser向用户申请权限。 257 258## 12100013 全局开关已开启 259 260**错误信息** 261 262The specific global switch is already open. 263 264**错误描述** 265 266当全局开关已开启时,将返回该错误码。 267 268**可能原因** 269 270全局开关已开启。 271 272**处理步骤** 273 274无需处理,返回此错误码表示全局开关已开启,不会拉起全局开关设置弹框。 275