diff --git a/zh-cn/application-dev/reference/apis/enterpriseDeviceManagement-overview.md b/zh-cn/application-dev/reference/apis/enterpriseDeviceManagement-overview.md index 927d323ef285e6544935a94d8b890252b3096b06..f50f24a03f4218593d41fa8a1e3793ac078d1bf7 100644 --- a/zh-cn/application-dev/reference/apis/enterpriseDeviceManagement-overview.md +++ b/zh-cn/application-dev/reference/apis/enterpriseDeviceManagement-overview.md @@ -5,6 +5,9 @@ OpenHarmony通过企业设备管理（Enterprise Device Management）API支持 ## 开发企业管理应用 +### 基本概念 +- 设备管理员应用：具备[企业设备管理扩展能力](../../application-models/enterprise-extensionAbility.md)的系统应用。 + ### 约束与限制 - 仅支持Stage模型 @@ -34,6 +37,8 @@ OpenHarmony通过企业设备管理（Enterprise Device Management）API支持 - [@ohos.enterprise.dateTimeManager (系统时间管理)](js-apis-enterprise-dateTimeManager.md) - [@ohos.enterprise.deviceControl (设备控制管理)](js-apis-enterprise-deviceControl.md) - [@ohos.enterprise.deviceInfo (设备信息管理)](js-apis-enterprise-deviceInfo.md) +- [@ohos.enterprise.deviceSettings (设备设置管理)](js-apis-enterprise-deviceSettings.md) - [@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)](js-apis-EnterpriseAdminExtensionAbility.md) - [@ohos.enterprise.networkManager (网络管理)](js-apis-enterprise-networkManager.md) +- [@ohos.enterprise.restrictions (限制类策略)](js-apis-enterprise-restrictions.md) - [@ohos.enterprise.wifiManager (WiFi管理)](js-apis-enterprise-wifiManager.md) \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-accountManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-accountManager.md index 9b16cab6f0c59833c5057fad69554d395e79d8ec..02bf35d0e50b4a6dbee9ac7eeab16270e1c972ff 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-accountManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-accountManager.md @@ -1,11 +1,12 @@ # @ohos.enterprise.accountManager（帐户管理） -本模块提供设备帐户管理能力，包括禁止创建本地用户等。仅企业设备管理员应用才能调用。 +本模块提供设备帐户管理能力，包括禁止创建本地用户等。 > **说明：** > > 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -> 本模块接口需激活为[设备管理员应用](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后才能调用，实现相应功能。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md index 85edaac82120b0e2c3620c6ca11c0a70191b969a..8a40383016240006d26233edf8b4ca95f485d221 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md @@ -5,6 +5,8 @@ > **说明：** > > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，实现相应功能。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-applicationManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-applicationManager.md index c561b5e60d75f3c264bd6c3de888b41029043cf4..e8dd7c80b4d2e5cd88c340b7cbdcac48d958dca6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-applicationManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-applicationManager.md @@ -1,11 +1,12 @@ # @ohos.enterprise.applicationManager（应用管理） -本模块提供应用管理能力，包括添加应用运行黑名单、获取应用运行黑名单、移除应用运行黑名单等。仅企业设备管理员应用才能调用。 +本模块提供应用管理能力，包括添加应用运行黑名单、获取应用运行黑名单、移除应用运行黑名单等。 > **说明：** > > 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -> 本模块接口需激活为[设备管理员应用](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后才能调用，实现相应功能。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-bundleManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-bundleManager.md index e0089f66e217a950e10ac35271c31d968206bd71..5ba0e7171c93c7e711f23f3b041c9380abee6962 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-bundleManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-bundleManager.md @@ -1,11 +1,12 @@ # @ohos.enterprise.bundleManager（包管理） -本模块提供包管理能力，包括添加包安装白名单、获取包安装白名单、移除包安装白名单等。仅企业设备管理员应用才能调用。 +本模块提供包管理能力，包括添加包安装白名单、获取包安装白名单、移除包安装白名单等。 > **说明：** > > 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -> 本模块接口需激活为[设备管理员应用](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后才能调用，实现相应功能。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-dateTimeManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-dateTimeManager.md index e8bcbadbfe0c87f8278f78fa0ac5d166e4a49f77..e728c9ac20e8b6ca9be246191d544accc42a2265 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-dateTimeManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-dateTimeManager.md @@ -1,11 +1,12 @@ # @ohos.enterprise.dateTimeManager (系统时间管理) -本模块提供系统时间管理能力。仅企业设备管理员应用才能调用。 +本模块提供系统时间管理能力。 > **说明**： > > 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -> 本模块接口需激活为[设备管理员应用](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后才能调用，实现相应功能。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 ## 导入模块 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 index 829b9cebe7c9f0dc05d6ed9661d72c43d17a2e23..7b005bed7aada440728e662fc955984df10d98f0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceControl.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceControl.md @@ -1,11 +1,12 @@ # @ohos.enterprise.deviceControl (设备控制管理) -本模块提供设备控制能力。仅企业设备管理员应用才能调用。 +本模块提供设备控制能力。 > **说明**： > > 本模块首批接口从API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -> 本模块接口需激活为[设备管理员应用](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后才能调用，实现相应功能。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md index 49e563cf14f3a88c2325a9fb60e8a40cbe2ae131..8df0544a9e9a4da3352a3b98f63eaec34ee03944 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md @@ -1,11 +1,12 @@ # @ohos.enterprise.deviceInfo（设备信息管理） -本模块提供企业设备信息管理能力，包括获取设备序列号等。仅企业设备管理员应用才能调用。 +本模块提供企业设备信息管理能力，包括获取设备序列号等。 > **说明：** > > 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -> 本模块接口需激活为[设备管理员应用](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后才能调用，实现相应功能。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceSetings.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceSettings.md similarity index 93% rename from zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceSetings.md rename to zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceSettings.md index 0cf53d40c58afaac172e8af0d7abdd471747a05e..d660e73fd6b905f8519e8dd691f510a0e7f2e181 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceSetings.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceSettings.md @@ -1,10 +1,12 @@ # @ohos.enterprise.deviceSettings (设备设置管理) -本模块提供企业设备设置能力，包括获取设备息屏时间等。仅企业设备管理员应用才能调用。 +本模块提供企业设备设置能力，包括获取设备息屏时间等。 > **说明：** > > 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-networkManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-networkManager.md index 86aa787e27c51efa751bcd55252b23f1c6f95369..d78499bf78eb2bf3e493f8ebf65f8052a8cbda54 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-networkManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-networkManager.md @@ -1,11 +1,12 @@ # @ohos.enterprise.networkManager（网络管理） -本模块提供设备网络管理能力，包括查询设备IP地址、MAC地址信息等。仅企业设备管理员应用才能调用。 +本模块提供设备网络管理能力，包括查询设备IP地址、MAC地址信息等。 > **说明：** > > 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -> 本模块接口需激活为[设备管理员应用](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后才能调用，实现相应功能。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-restrictions.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-restrictions.md new file mode 100644 index 0000000000000000000000000000000000000000..c65dcd30055388ba4e58610affb0a723abc5386d --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-restrictions.md @@ -0,0 +1,391 @@ +# @ohos.enterprise.restrictions (限制类策略) + +本模块提供设置通用限制类策略能力，包括禁用或启用设备打印、HDC等能力。 + +> **说明**： +> +> 本模块首批接口从API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 + +## 导入模块 + +```js +import restrictions from '@ohos.enterprise.restrictions' +``` + +## restrictions.setPrinterDisabled + +setPrinterDisabled(admin: Want, disabled: boolean, callback: AsyncCallback\): void + +指定设备管理员应用禁用或启用设备打印能力。使用callback形式返回禁用或启用结果。 + +**需要权限：** ohos.permission.ENTERPRISE_RESTRICT_POLICY + +**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | +| disabled | boolean | 是 | true表示禁止使用打印能力，false表示允许使用打印能力。 | +| 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', +}; + +restrictions.setPrinterDisabled(wantTemp, true, (err) => { + if (err) { + console.error(`Failed to set printer disabled. Code is ${err.code}, message is ${err.message}`); + return; + } + console.info('Succeeded in setting printer disabled'); +}) +``` + +## restrictions.setPrinterDisabled + +setPrinterDisabled(admin: Want, disabled: boolean): Promise\ + +指定设备管理员应用禁用或启用设备打印能力。使用Promise形式返回禁用或启用结果。 + +**需要权限：** ohos.permission.ENTERPRISE_RESTRICT_POLICY + +**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | +| disabled | boolean | 是 | true表示禁止使用打印能力，false表示允许使用打印能力。 | + +**返回值：** + +| 类型 | 说明 | +| ----- | ----------------------------------- | +| 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', +}; + +restrictions.setPrinterDisabled(wantTemp, true).then(() => { + console.info('Succeeded in setting printer disabled'); +}).catch((err) => { + console.error(`Failed to set printer disabled. Code is ${err.code}, message is ${err.message}`); +}) +``` + +## restrictions.isPrinterDisabled + +isPrinterDisabled(admin: Want, callback: AsyncCallback\): void + +指定设备管理员应用查询设备打印能力是否被禁用。使用callback形式返回结果。 + +**需要权限：** ohos.permission.ENTERPRISE_RESTRICT_POLICY + +**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | +| callback | AsyncCallback\ | 是 | 回调函数，callback方式返回设备打印能力是否被禁用，true表示设备打印能力被禁用，false表示设备打印能力未被禁用。 | + +**错误码**： + +以下的错误码的详细介绍请参见[企业设备管理错误码](../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', +}; + +restrictions.isPrinterDisabled(wantTemp, (err, result) => { + if (err) { + console.error(`Failed to query is the printing function disabled or not. Code is ${err.code}, message is ${err.message}`); + return; + } + console.info(`Succeeded in querying is the printing function disabled : ${result}`); +}) +``` + +## restrictions.isPrinterDisabled + +isPrinterDisabled(admin: Want): Promise\ + +指定设备管理员应用查询设备打印能力是否被禁用。使用Promise形式返回结果。 + +**需要权限：** ohos.permission.ENTERPRISE_RESTRICT_POLICY + +**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | + +**返回值：** + +| 类型 | 说明 | +| ----- | ----------------------------------- | +| Promise\ | Promise对象。promise方式返回设备打印能力是否被禁用，true表示设备打印能力被禁用，false表示设备打印能力未被禁用。 | + +**错误码**： + +以下的错误码的详细介绍请参见[企业设备管理错误码](../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', +}; + +restrictions.isPrinterDisabled(wantTemp).then((result) => { + console.info(`Succeeded in querying is the printing function disabled : ${result}`); +}).catch((err) => { + console.error(`Failed to query is the printing function disabled or not. Code is ${err.code}, message is ${err.message}`); +}) +``` + +## restrictions.setHdcDisabled + +setHdcDisabled(admin: Want, disabled: boolean, callback: AsyncCallback\): void + +指定设备管理员应用禁用或启用HDC。使用callback形式返回结果。 + +**需要权限：** ohos.permission.ENTERPRISE_RESTRICT_POLICY + +**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | +| disabled | boolean | 是 | true表示禁止使用HDC，false表示允许使用HDC。 | +| 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', +}; + +restrictions.setHdcDisabled(wantTemp, true, (err) => { + if (err) { + console.error(`Failed to set hdc disabled. Code is ${err.code}, message is ${err.message}`); + return; + } + console.info('Succeeded in setting hdc disabled'); +}) +``` + +## restrictions.setHdcDisabled + +setHdcDisabled(admin: Want, disabled: boolean): Promise\ + +指定设备管理员应用禁用或启用HDC。使用Promise形式返回结果。 + +**需要权限：** ohos.permission.ENTERPRISE_RESTRICT_POLICY + +**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | +| disabled | boolean | 是 | true表示禁止使用HDC，false表示允许使用HDC。 | + +**返回值：** + +| 类型 | 说明 | +| ----- | ----------------------------------- | +| Promise\ | 无返回结果的Promise对象。当指定设备管理员应用禁止或允许使用HDC失败时抛出错误对象。 | + +**错误码**： + +以下的错误码的详细介绍请参见[企业设备管理错误码](../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', +}; + +restrictions.setHdcDisabled(wantTemp, true).then(() => { + console.info('Succeeded in setting hdc disabled'); +}).catch((err) => { + console.error(`Failed to set hdc disabled. Code is ${err.code}, message is ${err.message}`); +}) +``` + +## restrictions.isHdcDisabled + +isHdcDisabled(admin: Want, callback: AsyncCallback\): void + +指定设备管理员应用查询HDC是否被禁用。使用callback形式返回结果。 + +**需要权限：** ohos.permission.ENTERPRISE_RESTRICT_POLICY + +**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | +| callback | AsyncCallback\ | 是 | 回调函数，callbac方式返回HDC是否被禁用，true表示HDC被禁用，false表示HDC未被禁用。 | + +**错误码**： + +以下的错误码的详细介绍请参见[企业设备管理错误码](../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', +}; + +restrictions.isHdcDisabled(wantTemp, (err, result) => { + if (err) { + console.error(`Failed to query is hdc disabled or not. Code is ${err.code}, message is ${err.message}`); + return; + } + console.info(`Succeeded in querying is hdc disabled : ${result}`); +}) +``` + +## restrictions.isHdcDisabled + +isHdcDisabled(admin: Want): Promise\ + +指定设备管理员应用查询HDC是否被禁用。使用Promise形式返回结果。 + +**需要权限：** ohos.permission.ENTERPRISE_RESTRICT_POLICY + +**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | + +**返回值：** + +| 类型 | 说明 | +| ----- | ----------------------------------- | +| Promise\ | Promise对象。promise方式返回HDC是否被禁用，true表示HDC被禁用，false表示HDC未被禁用。 | + +**错误码**： + +以下的错误码的详细介绍请参见[企业设备管理错误码](../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', +}; + +restrictions.isHdcDisabled(wantTemp).then((result) => { + console.info(`Succeeded in querying is hdc disabled : ${result}`); +}).catch((err) => { + console.error(`Failed to query is hdc disabled or not. Code is ${err.code}, message is ${err.message}`); +}) +``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-wifiManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-wifiManager.md index e2ef406241f9a41bb8a834946296992182d352d3..acc2545f983dd52fb3a75267ffe22e087df236ea 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-wifiManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-wifiManager.md @@ -1,11 +1,12 @@ # @ohos.enterprise.wifiManager（WiFi管理） -本模块提供企业设备WiFi管理能力，包括查询WiFi开启状态等。仅企业设备管理员应用才能调用。 +本模块提供企业设备WiFi管理能力，包括查询WiFi开启状态等。 > **说明：** > > 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -> 本模块接口需激活为[设备管理员应用](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后才能调用，实现相应功能。 +> +> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放，需将[设备管理员应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用，实现相应功能。 ## 导入模块