From ac8a3596ceaec6d8f02b6ed2128c44043e43b2e3 Mon Sep 17 00:00:00 2001 From: liwuli Date: Wed, 8 Feb 2023 10:40:49 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=81=A2=E5=A4=8D=E5=87=BA?= =?UTF-8?q?=E5=8E=82=E8=AE=BE=E7=BD=AE=E6=8E=A5=E5=8F=A3md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liwuli --- .../apis/js-apis-enterprise-deviceControl.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceControl.md diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceControl.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceControl.md new file mode 100644 index 0000000000..d497f07be9 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceControl.md @@ -0,0 +1,101 @@ +# @ohos.enterprise.deviceControl (设备控制管理) + +本模块提供设备控制能力。仅企业设备管理员应用才能调用。 + +> **说明**: +> +> 本模块首批接口从API version 10 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 + +## 导入模块 + +```js +import deviceControl from '@ohos.enterprise.deviceControl' +``` + +## deviceControl.resetFactory + +resetFactory(admin: Want, callback: AsyncCallback): void + +恢复出厂设置。使用callback异步回调。 + +**需要权限:** ohos.permission.ENTERPRISE_RESET_DEVICE + +**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | +| callback | AsyncCallback\ | 是 | 回调函数。当系统时间设置成功err为null,否则为错误对象。 | + +**错误码**: + +以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md)。 + +| 错误码ID | 错误信息 | +| ------- | ---------------------------------------------------------------------------- | +| 9200001 | the application is not an administrator of the device. | +| 9200002 | the administrator application does not have permission to manage the device. | + +**示例:** + +```js +let wantTemp = { + bundleName: "bundleName", + abilityName: "abilityName", +}; +deviceControl.resetFactory(wantTemp, (error) => { + if (error) { + console.log("error code:" + error.code + " error message:" + error.message); + } +}) +``` + +## deviceControl.resetFactory + +resetFactory(admin: Want): Promise + +恢复出厂设置。使用Promise异步回调。 + +**需要权限:** ohos.permission.ENTERPRISE_RESET_DEVICE + +**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | + +**返回值:** + +| 类型 | 说明 | +| ----- | ----------------------------------- | +| Promise\ | Promise对象。无返回结果的Promise对象。 | + +**错误码**: + +以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md)。 + +| 错误码ID | 错误信息 | +| ------- | ---------------------------------------------------------------------------- | +| 9200001 | the application is not an administrator of the device. | +| 9200002 | the administrator application does not have permission to manage the device. | + +**示例:** + +```js +let wantTemp = { + bundleName: "bundleName", + abilityName: "abilityName", +}; +deviceControl.resetFactory(wantTemp).then(() => { +}).catch((error) => { + console.log("error code:" + error.code + " error message:" + error.message); +}) +``` -- GitLab