• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.enterprise.applicationManager(应用管理)(系统接口)
2<!--Kit: MDM Kit-->
3<!--Subsystem: Customization-->
4<!--Owner: @huanleima-->
5<!--Designer: @liuzuming-->
6<!--Tester: @lpw_work-->
7<!--Adviser: @Brilliantry_Rui-->
8
9本模块提供应用管理能力,包括添加应用运行禁止名单、获取应用运行禁止名单、移除应用运行禁止名单等。
10
11> **说明:**
12>
13> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
14>
15> 本模块接口仅可在Stage模型下使用。
16>
17> 本模块接口仅对[设备管理应用](../../mdm/mdm-kit-term.md#mdm应用设备管理应用)开放,需将[设备管理应用激活](js-apis-enterprise-adminManager-sys.md#adminmanagerenableadmin-2)后调用。
18>
19> 当前页面仅包含本模块的系统接口,其他公开接口参见。其他公开接口参见[@ohos.enterprise.applicationManager](js-apis-enterprise-applicationManager.md)。
20
21## 导入模块
22
23```ts
24import { applicationManager } from '@kit.MDMKit';
25```
26
27## applicationManager.addDisallowedRunningBundles
28
29addDisallowedRunningBundles(admin: Want, appIds: Array\<string>, callback: AsyncCallback&lt;void&gt;): void
30
31添加应用至应用运行禁止名单,添加至禁止名单的应用不允许在当前用户下运行,不在禁止名单中的应用允许运行。使用callback异步回调。
32
33**需要权限:** ohos.permission.ENTERPRISE_MANAGE_SET_APP_RUNNING_POLICY
34
35**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager
36
37**模型约束:** 此接口仅可在Stage模型下使用。
38
39**系统接口:** 此接口为系统接口。
40
41**参数:**
42
43| 参数名      | 类型                                       | 必填   | 说明                       |
44| -------- | ---------------------------------------- | ---- | ------------------------------- |
45| admin    | [Want](../apis-ability-kit/js-apis-app-ability-want.md)     | 是    | 企业设备管理扩展组件。            |
46| appIds    | Array&lt;string&gt;                | 是    | 应用ID数组,指定具体应用。                  |
47| callback | AsyncCallback&lt;void&gt;            | 是    | 回调函数。当接口调用成功,err为null,否则为错误对象。 |
48
49**错误码**:
50
51以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。
52
53| 错误码ID | 错误信息                                                                       |
54| ------- | ---------------------------------------------------------------------------- |
55| 9200001 | The application is not an administrator application of the device.            |
56| 9200002 | The administrator application does not have permission to manage the device. |
57| 201 | Permission verification failed. The application does not have the permission required to call the API. |
58| 202 | Permission verification failed. A non-system application calls a system API. |
59| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
60
61
62**示例:**
63
64```ts
65import { applicationManager } from '@kit.MDMKit';
66import { Want } from '@kit.AbilityKit';
67
68let wantTemp: Want = {
69  // 需根据实际情况进行替换
70  bundleName: 'com.example.myapplication',
71  abilityName: 'EntryAbility'
72};
73// 需根据实际情况进行替换
74let appIds: Array<string> = ['com.example.******_******/******5t5CoBM='];
75
76applicationManager.addDisallowedRunningBundles(wantTemp, appIds, (err) => {
77  if (err) {
78    console.error(`Failed to add disallowed running bundles. Code is ${err.code}, message is ${err.message}`);
79    return;
80  }
81  console.info('Succeeded in adding disallowed running bundles');
82});
83```
84
85## applicationManager.addDisallowedRunningBundles
86
87addDisallowedRunningBundles(admin: Want, appIds: Array\<string>, userId: number, callback: AsyncCallback&lt;void&gt;): void
88
89添加应用至应用运行禁止名单,添加至禁止名单的应用不允许在指定用户(通过userId指定)下运行,不在禁止名单中的应用允许运行。使用callback异步回调。
90
91**需要权限:** ohos.permission.ENTERPRISE_MANAGE_SET_APP_RUNNING_POLICY
92
93**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager
94
95**模型约束:** 此接口仅可在Stage模型下使用。
96
97**系统接口:** 此接口为系统接口。
98
99**参数:**
100
101| 参数名   | 类型                                  | 必填   | 说明      |
102| ----- | ----------------------------------- | ---- | ------- |
103| admin    | [Want](../apis-ability-kit/js-apis-app-ability-want.md)     | 是    | 企业设备管理扩展组件。            |
104| appIds    | Array&lt;string&gt;                | 是    | 应用ID数组,指定具体应用。                  |
105| userId     | number                             | 是    | 用户ID,指定具体用户。取值范围:大于等于0。 |
106| callback | AsyncCallback&lt;void&gt;            | 是    | 回调函数,当接口调用成功,err为null,否则为错误对象。 |
107
108**错误码**:
109
110以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。
111
112| 错误码ID | 错误信息                                                                     |
113| ------- | ---------------------------------------------------------------------------- |
114| 9200001 | The application is not an administrator application of the device.            |
115| 9200002 | The administrator application does not have permission to manage the device. |
116| 201 | Permission verification failed. The application does not have the permission required to call the API. |
117| 202 | Permission verification failed. A non-system application calls a system API. |
118| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
119
120**示例:**
121
122```ts
123import { applicationManager } from '@kit.MDMKit';
124import { Want } from '@kit.AbilityKit';
125
126let wantTemp: Want = {
127  // 需根据实际情况进行替换
128  bundleName: 'com.example.myapplication',
129  abilityName: 'EntryAbility'
130};
131// 需根据实际情况进行替换
132let appIds: Array<string> = ['com.example.******_******/******5t5CoBM='];
133
134applicationManager.addDisallowedRunningBundles(wantTemp, appIds, 100, (err) => {
135  if (err) {
136    console.error(`Failed to add disallowed running bundles. Code is ${err.code}, message is ${err.message}`);
137    return;
138  }
139  console.info('Succeeded in adding disallowed running bundles');
140});
141```
142
143## applicationManager.addDisallowedRunningBundles
144
145addDisallowedRunningBundles(admin: Want, appIds: Array\<string>, userId?: number): Promise&lt;void&gt;
146
147添加应用至应用运行禁止名单,添加至禁止名单的应用不允许在当前/指定用户下运行。使用promise异步回调。
148
149**需要权限:** ohos.permission.ENTERPRISE_MANAGE_SET_APP_RUNNING_POLICY
150
151**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager
152
153**模型约束:** 此接口仅可在Stage模型下使用。
154
155**系统接口:** 此接口为系统接口。
156
157**参数:**
158
159| 参数名   | 类型                                  | 必填   | 说明      |
160| ----- | ----------------------------------- | ---- | ------- |
161| admin    | [Want](../apis-ability-kit/js-apis-app-ability-want.md)     | 是    | 企业设备管理扩展组件。            |
162| appIds    | Array&lt;string&gt;                | 是    | 应用ID数组,指定具体应用。                  |
163| userId     | number                             | 否    | 用户ID,取值范围:大于等于0。<br> - 调用接口时,若传入userId,表示指定用户。<br> - 调用接口时,若未传入userId,表示当前用户。 |
164
165**返回值:**
166
167| 类型                   | 说明                      |
168| --------------------- | ------------------------- |
169| Promise&lt;void&gt; | 无返回结果的Promise对象。当添加应用运行禁止名单失败时,会抛出错误对象。  |
170
171**错误码**:
172
173以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。
174
175| 错误码ID | 错误信息                                                                     |
176| ------- | ---------------------------------------------------------------------------- |
177| 9200001 | The application is not an administrator application of the device.            |
178| 9200002 | The administrator application does not have permission to manage the device. |
179| 201 | Permission verification failed. The application does not have the permission required to call the API. |
180| 202 | Permission verification failed. A non-system application calls a system API. |
181| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
182
183**示例:**
184
185```ts
186import { applicationManager } from '@kit.MDMKit';
187import { Want } from '@kit.AbilityKit';
188import { BusinessError } from '@kit.BasicServicesKit';
189
190let wantTemp: Want = {
191  // 需根据实际情况进行替换
192  bundleName: 'com.example.myapplication',
193  abilityName: 'EntryAbility'
194};
195// 需根据实际情况进行替换
196let appIds: Array<string> = ['com.example.******_******/******5t5CoBM='];
197
198applicationManager.addDisallowedRunningBundles(wantTemp, appIds, 100).then(() => {
199  console.info('Succeeded in adding disallowed running bundles');
200}).catch((err: BusinessError) => {
201  console.error(`Failed to add disallowed running bundles. Code is ${err.code}, message is ${err.message}`);
202});
203```
204
205## applicationManager.removeDisallowedRunningBundles
206
207removeDisallowedRunningBundles(admin: Want, appIds: Array\<string>, callback: AsyncCallback&lt;void&gt;): void
208
209移除在应用运行禁止名单中的应用,在禁止名单存在的情况下,在应用运行禁止名单中的应用不允许在当前用户下运行。使用callback异步回调。
210
211**需要权限:** ohos.permission.ENTERPRISE_MANAGE_SET_APP_RUNNING_POLICY
212
213**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager
214
215**模型约束:** 此接口仅可在Stage模型下使用。
216
217**系统接口:** 此接口为系统接口。
218
219**参数:**
220
221| 参数名      | 类型                                       | 必填   | 说明                       |
222| -------- | ---------------------------------------- | ---- | ------------------------------- |
223| admin    | [Want](../apis-ability-kit/js-apis-app-ability-want.md)     | 是    | 企业设备管理扩展组件。            |
224| appIds    | Array&lt;string&gt;                | 是    | 应用ID数组,指定具体应用。                  |
225| callback | AsyncCallback&lt;void&gt;            | 是    | 回调函数。当接口调用成功,err为null,否则为错误对象。 |
226
227**错误码**:
228
229以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。
230
231| 错误码ID | 错误信息                                                                       |
232| ------- | ---------------------------------------------------------------------------- |
233| 9200001 | The application is not an administrator application of the device.            |
234| 9200002 | The administrator application does not have permission to manage the device. |
235| 201 | Permission verification failed. The application does not have the permission required to call the API. |
236| 202 | Permission verification failed. A non-system application calls a system API. |
237| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
238
239**示例:**
240
241```ts
242import { applicationManager } from '@kit.MDMKit';
243import { Want } from '@kit.AbilityKit';
244
245let wantTemp: Want = {
246  // 需根据实际情况进行替换
247  bundleName: 'com.example.myapplication',
248  abilityName: 'EntryAbility'
249};
250// 需根据实际情况进行替换
251let appIds: Array<string> = ['com.example.******_******/******5t5CoBM='];
252
253applicationManager.removeDisallowedRunningBundles(wantTemp, appIds, (err) => {
254  if (err) {
255    console.error(`Failed to remove disallowed running bundles. Code is ${err.code}, message is ${err.message}`);
256    return;
257  }
258  console.info('Succeeded in removing disallowed running bundles');
259});
260```
261
262## applicationManager.removeDisallowedRunningBundles
263
264removeDisallowedRunningBundles(admin: Want, appIds: Array\<string>, userId: number, callback: AsyncCallback&lt;void&gt;): void
265
266移除在应用运行禁止名单中的应用,在禁止名单存在的情况下,在应用运行禁止名单中的应用不允许在指定用户(通过userId指定)下运行。使用callback异步回调。
267
268**需要权限:** ohos.permission.ENTERPRISE_MANAGE_SET_APP_RUNNING_POLICY
269
270**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager
271
272**模型约束:** 此接口仅可在Stage模型下使用。
273
274**系统接口:** 此接口为系统接口。
275
276**参数:**
277
278| 参数名   | 类型                                  | 必填   | 说明      |
279| ----- | ----------------------------------- | ---- | ------- |
280| admin    | [Want](../apis-ability-kit/js-apis-app-ability-want.md)     | 是    | 企业设备管理扩展组件。            |
281| appIds    | Array&lt;string&gt;                | 是    | 应用ID数组,指定具体应用。                  |
282| userId     | number                             | 是    | 用户ID,指定具体用户。取值范围:大于等于0。 |
283| callback | AsyncCallback&lt;void&gt;            | 是    | 回调函数。当接口调用成功,err为null,否则为错误对象。 |
284
285**错误码**:
286
287以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。
288
289| 错误码ID | 错误信息                                                                     |
290| ------- | ---------------------------------------------------------------------------- |
291| 9200001 | The application is not an administrator application of the device.            |
292| 9200002 | The administrator application does not have permission to manage the device. |
293| 201 | Permission verification failed. The application does not have the permission required to call the API. |
294| 202 | Permission verification failed. A non-system application calls a system API. |
295| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
296
297**示例:**
298
299```ts
300import { applicationManager } from '@kit.MDMKit';
301import { Want } from '@kit.AbilityKit';
302
303let wantTemp: Want = {
304  // 需根据实际情况进行替换
305  bundleName: 'com.example.myapplication',
306  abilityName: 'EntryAbility'
307};
308// 需根据实际情况进行替换
309let appIds: Array<string> = ['com.example.******_******/******5t5CoBM='];
310
311applicationManager.removeDisallowedRunningBundles(wantTemp, appIds, 100, (err) => {
312  if (err) {
313    console.error(`Failed to remove disallowed running bundles. Code is ${err.code}, message is ${err.message}`);
314    return;
315  }
316  console.info('Succeeded in removing disallowed running bundles');
317});
318```
319
320## applicationManager.removeDisallowedRunningBundles
321
322removeDisallowedRunningBundles(admin: Want, appIds: Array\<string>, userId?: number): Promise&lt;void&gt;
323
324移除当前/指定用户在应用运行禁止名单中的应用,使用promise异步回调。
325
326**需要权限:** ohos.permission.ENTERPRISE_MANAGE_SET_APP_RUNNING_POLICY
327
328**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager
329
330**模型约束:** 此接口仅可在Stage模型下使用。
331
332**系统接口:** 此接口为系统接口。
333
334
335**参数:**
336
337| 参数名   | 类型                                  | 必填   | 说明      |
338| ----- | ----------------------------------- | ---- | ------- |
339| admin    | [Want](../apis-ability-kit/js-apis-app-ability-want.md)     | 是    | 企业设备管理扩展组件。            |
340| appIds    | Array&lt;string&gt;                | 是    | 应用ID数组,指定具体应用。                  |
341| userId     | number                             | 否    | 用户ID,取值范围:大于等于0。<br> - 调用接口时,若传入userId,表示指定用户。<br> - 调用接口时,若未传入userId,表示当前用户。 |
342
343**返回值:**
344
345| 类型                   | 说明                      |
346| --------------------- | ------------------------- |
347| Promise&lt;void&gt; | 无返回结果的Promise对象。当移除应用运行禁止名单失败时,会抛出错误对象。  |
348
349**错误码**:
350
351以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。
352
353| 错误码ID | 错误信息                                                                     |
354| ------- | ---------------------------------------------------------------------------- |
355| 9200001 | The application is not an administrator application of the device.            |
356| 9200002 | The administrator application does not have permission to manage the device. |
357| 201 | Permission verification failed. The application does not have the permission required to call the API. |
358| 202 | Permission verification failed. A non-system application calls a system API. |
359| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
360
361**示例:**
362
363```ts
364import { applicationManager } from '@kit.MDMKit';
365import { Want } from '@kit.AbilityKit';
366import { BusinessError } from '@kit.BasicServicesKit';
367
368let wantTemp: Want = {
369  // 需根据实际情况进行替换
370  bundleName: 'com.example.myapplication',
371  abilityName: 'EntryAbility'
372};
373// 需根据实际情况进行替换
374let appIds: Array<string> = ['com.example.******_******/******5t5CoBM='];
375
376applicationManager.removeDisallowedRunningBundles(wantTemp, appIds, 100).then(() => {
377  console.info('Succeeded in removing disallowed running bundles');
378}).catch((err: BusinessError) => {
379  console.error(`Failed to remove disallowed running bundles. Code is ${err.code}, message is ${err.message}`);
380});
381```
382
383## applicationManager.getDisallowedRunningBundles
384
385getDisallowedRunningBundles(admin: Want, callback: AsyncCallback&lt;Array&lt;string&gt;&gt;): void
386
387获取当前用户下的应用运行禁止名单。使用callback异步回调。
388
389**需要权限:** ohos.permission.ENTERPRISE_MANAGE_SET_APP_RUNNING_POLICY
390
391**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager
392
393**系统接口:** 此接口为系统接口。
394
395**参数:**
396
397| 参数名      | 类型                                       | 必填   | 说明                       |
398| -------- | ---------------------------------------- | ---- | ------------------------------- |
399| admin    | [Want](../apis-ability-kit/js-apis-app-ability-want.md)     | 是    | 企业设备管理扩展组件。            |
400| callback | AsyncCallback&lt;Array&lt;string&gt;&gt;       | 是    | 回调函数,当接口调用成功,err为null,否则为错误对象。       |
401
402**错误码**:
403
404以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。
405
406| 错误码ID | 错误信息                                                                       |
407| ------- | ---------------------------------------------------------------------------- |
408| 9200001 | The application is not an administrator application of the device.            |
409| 9200002 | The administrator application does not have permission to manage the device. |
410| 201 | Permission verification failed. The application does not have the permission required to call the API. |
411| 202 | Permission verification failed. A non-system application calls a system API. |
412| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
413
414**示例:**
415
416```ts
417import { applicationManager } from '@kit.MDMKit';
418import { Want } from '@kit.AbilityKit';
419
420let wantTemp: Want = {
421  // 需根据实际情况进行替换
422  bundleName: 'com.example.myapplication',
423  abilityName: 'EntryAbility'
424};
425
426applicationManager.getDisallowedRunningBundles(wantTemp, (err, result) => {
427  if (err) {
428    console.error(`Failed to get disallowed running bundles. Code is ${err.code}, message is ${err.message}`);
429    return;
430  }
431  console.info(`Succeeded in getting disallowed running bundles, result : ${JSON.stringify(result)}`);
432});
433```
434
435## applicationManager.getDisallowedRunningBundles
436
437getDisallowedRunningBundles(admin: Want, userId: number, callback: AsyncCallback&lt;Array&lt;string&gt;&gt;): void
438
439获取指定用户(通过userId指定)下的应用运行禁止名单。使用callback异步回调。
440
441**需要权限:** ohos.permission.ENTERPRISE_MANAGE_SET_APP_RUNNING_POLICY
442
443**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager
444
445**模型约束:** 此接口仅可在Stage模型下使用。
446
447**系统接口:** 此接口为系统接口。
448
449**参数:**
450
451| 参数名      | 类型                                       | 必填   | 说明                       |
452| -------- | ---------------------------------------- | ---- | ------------------------------- |
453| admin    | [Want](../apis-ability-kit/js-apis-app-ability-want.md)     | 是    | 企业设备管理扩展组件。            |
454| userId     | number                             | 是    | 用户ID,指定具体用户。取值范围:大于等于0。 |
455| callback | AsyncCallback&lt;Array&lt;string&gt;&gt;       | 是    | 回调函数,当接口调用成功,err为null,否则为错误对象。       |
456
457**错误码**:
458
459以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。
460
461| 错误码ID | 错误信息                                                                       |
462| ------- | ---------------------------------------------------------------------------- |
463| 9200001 | The application is not an administrator application of the device.            |
464| 9200002 | The administrator application does not have permission to manage the device. |
465| 201 | Permission verification failed. The application does not have the permission required to call the API. |
466| 202 | Permission verification failed. A non-system application calls a system API. |
467| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
468
469**示例:**
470
471```ts
472import { applicationManager } from '@kit.MDMKit';
473import { Want } from '@kit.AbilityKit';
474
475let wantTemp: Want = {
476  // 需根据实际情况进行替换
477  bundleName: 'com.example.myapplication',
478  abilityName: 'EntryAbility'
479};
480
481applicationManager.getDisallowedRunningBundles(wantTemp, 100, (err, result) => {
482  if (err) {
483    console.error(`Failed to get disallowed running bundles. Code is ${err.code}, message is ${err.message}`);
484    return;
485  }
486  console.info(`Succeeded in getting disallowed running bundles, result : ${JSON.stringify(result)}`);
487});
488```
489
490## applicationManager.getDisallowedRunningBundles
491
492getDisallowedRunningBundles(admin: Want, userId?: number): Promise&lt;Array&lt;string&gt;&gt;
493
494获取当前/指定用户下的应用运行禁止名单,使用promise异步回调。
495
496**需要权限:** ohos.permission.ENTERPRISE_MANAGE_SET_APP_RUNNING_POLICY
497
498**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager
499
500**模型约束:** 此接口仅可在Stage模型下使用。
501
502**系统接口:** 此接口为系统接口。
503
504**参数:**
505
506| 参数名   | 类型                                  | 必填   | 说明      |
507| ----- | ----------------------------------- | ---- | ------- |
508| admin | [Want](../apis-ability-kit/js-apis-app-ability-want.md) | 是    | 企业设备管理扩展组件。 |
509| userId     | number                             | 否    | 用户ID,取值范围:大于等于0。<br> - 调用接口时,若传入userId,表示指定用户。<br> - 调用接口时,若未传入userId,表示当前用户。 |
510
511**返回值:**
512
513| 类型                   | 说明                      |
514| --------------------- | ------------------------- |
515| Promise&lt;Array&lt;string&gt;&gt; | Promise对象,返回当前/指定用户下的应用运行禁止名单。 |
516
517**错误码**:
518
519以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。
520
521| 错误码ID | 错误信息                                                                     |
522| ------- | ---------------------------------------------------------------------------- |
523| 9200001 | The application is not an administrator application of the device.            |
524| 9200002 | The administrator application does not have permission to manage the device. |
525| 201 | Permission verification failed. The application does not have the permission required to call the API. |
526| 202 | Permission verification failed. A non-system application calls a system API. |
527| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
528
529**示例:**
530
531```ts
532import { applicationManager } from '@kit.MDMKit';
533import { Want } from '@kit.AbilityKit';
534import { BusinessError } from '@kit.BasicServicesKit';
535
536let wantTemp: Want = {
537  // 需根据实际情况进行替换
538  bundleName: 'com.example.myapplication',
539  abilityName: 'EntryAbility'
540};
541
542applicationManager.getDisallowedRunningBundles(wantTemp, 100).then((result) => {
543  console.info(`Succeeded in getting disallowed running bundles, result : ${JSON.stringify(result)}`);
544}).catch((err: BusinessError) => {
545  console.error(`Failed to get disallowed running bundles. Code is ${err.code}, message is ${err.message}`);
546});
547```
548