• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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