From 23904ca0a6f0b017c1c022fd612e445fa2ff2b45 Mon Sep 17 00:00:00 2001
From: yaohailiang <yaohailiang@huawei.com>
Date: Sat, 21 Jun 2025 15:46:46 +0800
Subject: [PATCH] doc for get user restrited

Signed-off-by: yaohailiang <yaohailiang@huawei.com>
---
 .../js-apis-enterprise-restrictions.md        | 58 ++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

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 9a2e089d265..4e66f69f38e 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
@@ -382,7 +382,7 @@ setUserRestriction(admin: Want, settingsItem: string, restricted: boolean): void
 | 参数名   | 类型                                                    | 必填 | 说明                                                         |
 | -------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ |
 | admin    | [Want](../apis-ability-kit/js-apis-app-ability-want.md) | 是   | 企业设备管理扩展组件。                                   |
-| settingsItem  | string                                                  | 是   | 行为名称。<br/>- setApn：APN设置，当前仅支持手机、平板使用。<br/>- powerLongPress：长按电源键打开电源菜单，当前仅支持手机、平板使用。 |
+| settingsItem  | string                                                  | 是   | 行为名称。<br/>- setApn：APN设置，当前仅支持手机、平板使用。<br/>- powerLongPress：长按电源键打开电源菜单，当前仅支持手机、平板使用。<br/>- setEthernetIp：修改以太网IP地址，该设置仅在PC/2in1设备上生效。<br/>- setDeviceName：修改设备名称。<br/>- setBiometricsAndScreenLock：修改锁屏密码。 |
 | restricted | boolean                                                 | 是   | 是否限制行为。true表示限制，false表示允许。                       |
 
 **错误码**：
@@ -412,4 +412,60 @@ try {
 } catch (err) {
   console.error(`Failed to restrict from setting apn. Code is ${err.code}, message is ${err.message}`);
 }
+```
+
+## restrictions.getUserRestricted<sup>20+</sup>
+
+getUserRestricted(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                                             | 是   | 指定设置项。<br/>- setEthernetIp：修改以太网IP地址，该设置仅在PC/2in1设备上生效。<br/>- setDeviceName：修改设备名称。<br/>- setBiometricsAndScreenLock：修改锁屏密码。 |
+
+**返回值：**
+
+| 类型    | 说明                                                         |
+| ------- | ------------------------------------------------------------ |
+| 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 '@kit.MDMKit';
+
+let wantTemp: Want = {
+  bundleName: 'com.example.myapplication',
+  abilityName: 'EntryAbility',
+};
+
+try {
+  let result: boolean = restrictions.getUserRestricted(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}`);
+}
 ```
\ No newline at end of file
-- 
Gitee