1# @ohos.enterprise.accountManager(帐户管理) 2 3本模块提供设备帐户管理能力,包括禁止创建本地用户等。 4 5> **说明:** 6> 7> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 8> 9> 本模块接口仅可在Stage模型下使用。 10> 11> 本模块接口仅对[设备管理应用](enterpriseDeviceManagement-overview.md#基本概念)开放,需将[设备管理应用激活](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后调用,实现相应功能。 12 13## 导入模块 14 15```ts 16import accountManager from '@ohos.enterprise.accountManager'; 17``` 18 19## accountManager.disallowAddLocalAccount 20 21disallowAddLocalAccount(admin: Want, disallow: boolean, callback: AsyncCallback<void>): void 22 23指定设备管理应用禁止设备创建本地用户。使用callback异步回调。 24 25**需要权限:** ohos.permission.ENTERPRISE_SET_ACCOUNT_POLICY 26 27**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager 28 29**系统API**: 此接口为系统接口。 30 31**参数:** 32 33| 参数名 | 类型 | 必填 | 说明 | 34| -------- | ---------------------------------------- | ---- | ------------------------------- | 35| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 36| disallow | boolean | 是 | 是否禁止创建本地用户,true表示禁止创建,false表示允许创建。 | 37| callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功,err为null,否则为错误对象。 | 38 39**错误码**: 40 41以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 42 43| 错误码ID | 错误信息 | 44| ------- | ---------------------------------------------------------------------------- | 45| 9200001 | the application is not an administrator of the device. | 46| 9200002 | the administrator application does not have permission to manage the device. | 47 48**示例:** 49 50```ts 51import Want from '@ohos.app.ability.Want'; 52let wantTemp: Want = { 53 bundleName: 'com.example.myapplication', 54 abilityName: 'EntryAbility', 55}; 56 57accountManager.disallowAddLocalAccount(wantTemp, true, (err) => { 58 if (err) { 59 console.error(`Failed to disallow add local account. Code: ${err.code}, message: ${err.message}`); 60 return; 61 } 62 console.info('Succeeded in disallowing add local account'); 63}); 64``` 65 66## accountManager.disallowAddLocalAccount 67 68disallowAddLocalAccount(admin: Want, disallow: boolean): Promise<void> 69 70指定设备管理应用禁止设备创建本地用户。使用promise异步回调。 71 72**需要权限:** ohos.permission.ENTERPRISE_SET_ACCOUNT_POLICY 73 74**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager 75 76**系统API**: 此接口为系统接口。 77 78**参数:** 79 80| 参数名 | 类型 | 必填 | 说明 | 81| ----- | ----------------------------------- | ---- | ------- | 82| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | 83| disallow | boolean | 是 | 是否禁止创建本地用户,true表示禁止创建,false表示允许创建。 | 84 85**返回值:** 86 87| 类型 | 说明 | 88| --------------------- | ------------------------- | 89| Promise<void> | 无返回结果的Promise对象。当禁止创建本地用户失败时,抛出错误对象。 | 90 91**错误码**: 92 93以下错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 94 95| 错误码ID | 错误信息 | 96| ------- | ---------------------------------------------------------------------------- | 97| 9200001 | the application is not an administrator of the device. | 98| 9200002 | the administrator application does not have permission to manage the device. | 99 100**示例:** 101 102```ts 103import Want from '@ohos.app.ability.Want'; 104import { BusinessError } from '@ohos.base'; 105let wantTemp: Want = { 106 bundleName: 'com.example.myapplication', 107 abilityName: 'EntryAbility', 108}; 109 110accountManager.disallowAddLocalAccount(wantTemp, true).then(() => { 111 console.info('Succeeded in disallowing add local account'); 112}).catch((err: BusinessError) => { 113 console.error(`Failed to disallow add local account. Code: ${err.code}, message: ${err.message}`); 114}); 115``` 116