From 8ea2e19b6d9a4c92b4d17781a82214602b83d2fb Mon Sep 17 00:00:00 2001 From: yaohailiang Date: Sat, 21 Jun 2025 15:46:46 +0800 Subject: [PATCH] doc for get user restrited Signed-off-by: yaohailiang --- .../js-apis-enterprise-restrictions.md | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/zh-cn/application-dev/reference/apis-mdm-kit/js-apis-enterprise-restrictions.md b/zh-cn/application-dev/reference/apis-mdm-kit/js-apis-enterprise-restrictions.md index 15e9c11779c..907d73a7233 100644 --- a/zh-cn/application-dev/reference/apis-mdm-kit/js-apis-enterprise-restrictions.md +++ b/zh-cn/application-dev/reference/apis-mdm-kit/js-apis-enterprise-restrictions.md @@ -366,3 +366,54 @@ try { console.error(`Failed to query disallowed list for account. Code is ${err.code}, message is ${err.message}`); } ``` + +## restrictions.getUserRestrited20+ + +getUserRestrited(admin: Want, settingsItem: string): boolean + +获取指定设置项的禁用状态。 + +**需要权限:** ohos.permission.ENTERPRISE_SET_USER_RESTRICTION + +**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | +| admin | [Want](../apis-ability-kit/js-apis-app-ability-want.md) | 是 | 企业设备管理扩展组件。 | +| settingsItem | string | 是 | 禁止修改的设置项。 | +**返回值:** + +| 类型 | 说明 | +| ------- | ------------------------------------------------------------ | +| boolean | 返回true表示settingsItem对应的设置项被禁用,false表示settingsItem对应的设置项未被禁用。 | + +**错误码**: + +以下错误码的详细介绍请参见[企业设备管理错误码](errorcode-enterpriseDeviceManager.md)和[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------------------------ | +| 9200001 | The application is not an administrator application of the device. | +| 9200002 | The administrator application does not have permission to manage the device. | +| 201 | Permission verification failed. The application does not have the permission required to call the API. | + +**示例:** + +```ts +import { Want } from '@kit.AbilityKit'; +import { restrictions } from '@ohos.enterprise.restrictions'; + +let wantTemp: Want = { + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', +}; + +try { + let result: boolean = restrictions.getUserRestrited(wantTemp, 'setEthernetIp'); + console.info('Succeeded in get user restrited'); +} catch (err) { + console.error(`Failed to get user restrited. Code is ${err.code}, message is ${err.message}`); +} +``` -- Gitee