• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.enterprise.deviceControl (设备控制管理)
2
3本模块提供设备控制能力。
4
5> **说明**：
6>
7> 本模块首批接口从API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8>
9> 本模块接口仅可在Stage模型下使用。
10>
11> 本模块接口仅对[设备管理应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。
12
13## 导入模块
14
15```ts
16import deviceControl from '@ohos.enterprise.deviceControl';
17```
18
19## deviceControl.resetFactory
20
21resetFactory(admin: Want, callback: AsyncCallback\<void>): void
22
23指定设备管理应用使设备恢复出厂设置。使用callback异步回调。
24
25**需要权限：** ohos.permission.ENTERPRISE_RESET_DEVICE
26
27**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager
28
29**系统API**: 此接口为系统接口。
30
31**参数：**
32
33| 参数名   | 类型                                  | 必填   | 说明      |
34| ----- | ----------------------------------- | ---- | ------- |
35| admin | [Want](js-apis-app-ability-want.md) | 是    | 设备管理应用。 |
36| callback | AsyncCallback\<void> | 是 | 回调函数。当接口调用成功，err为null，否则为错误对象。 |
37
38**错误码**：
39
40以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md)。
41
42| 错误码ID | 错误信息                                                                      |
43| ------- | ---------------------------------------------------------------------------- |
44| 9200001 | the application is not an administrator of the device.                       |
45| 9200002 | the administrator application does not have permission to manage the device. |
46
47**示例：**
48
49```ts
50import Want from '@ohos.app.ability.Want';
51let wantTemp: Want = {
52  bundleName: 'bundleName',
53  abilityName: 'abilityName',
54};
55
56deviceControl.resetFactory(wantTemp, (err) => {
57  if (err) {
58    console.error(`Failed to reset factory. Code is ${err.code}, message is ${err.message}`);
59    return;
60  }
61  console.log('Succeeded in resetting factory');
62})
63```
64
65## deviceControl.resetFactory
66
67resetFactory(admin: Want): Promise\<void>
68
69指定设备管理应用使设备恢复出厂设置。使用Promise异步回调。
70
71**需要权限：** ohos.permission.ENTERPRISE_RESET_DEVICE
72
73**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager
74
75**系统API**: 此接口为系统接口。
76
77**参数：**
78
79| 参数名   | 类型                                  | 必填   | 说明      |
80| ----- | ----------------------------------- | ---- | ------- |
81| admin | [Want](js-apis-app-ability-want.md) | 是    | 设备管理应用。 |
82
83**返回值：**
84
85| 类型   | 说明                                  |
86| ----- | ----------------------------------- |
87| Promise\<void> | 无返回结果的Promise对象。当恢复出厂设置失败时抛出错误对象。|
88
89**错误码**：
90
91以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md)。
92
93| 错误码ID | 错误信息                                                                      |
94| ------- | ---------------------------------------------------------------------------- |
95| 9200001 | the application is not an administrator of the device.                        |
96| 9200002 | the administrator application does not have permission to manage the device. |
97
98**示例：**
99
100```ts
101import Want from '@ohos.app.ability.Want';
102import { BusinessError } from '@ohos.base';
103let wantTemp: Want = {
104  bundleName: 'bundleName',
105  abilityName: 'abilityName',
106};
107
108deviceControl.resetFactory(wantTemp).then(() => {
109}).catch((err: BusinessError) => {
110  console.error(`Failed to reset factory. Code is ${err.code}, message is ${err.message}`);
111})
112```
113