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 9a2e089d2652fce1d5fd70f6de6c2fa612f305e4..4e66f69f38e5a9b8bcfaae5d0a2a9e4d4639a773 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 | 是 | 行为名称。
- setApn:APN设置,当前仅支持手机、平板使用。
- powerLongPress:长按电源键打开电源菜单,当前仅支持手机、平板使用。 | +| settingsItem | string | 是 | 行为名称。
- setApn:APN设置,当前仅支持手机、平板使用。
- powerLongPress:长按电源键打开电源菜单,当前仅支持手机、平板使用。
- setEthernetIp:修改以太网IP地址,该设置仅在PC/2in1设备上生效。
- setDeviceName:修改设备名称。
- 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.getUserRestricted20+ + +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 | 是 | 指定设置项。
- setEthernetIp:修改以太网IP地址,该设置仅在PC/2in1设备上生效。
- setDeviceName:修改设备名称。
- 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