1# @ohos.enterprise.adminManager (企业设备管理) 2 3本模块提供企业设备管理能力，使设备具备企业场景下所需的定制能力。 4 5> **说明：** 6> 7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11```js 12import adminManager from '@ohos.enterprise.adminManager'; 13``` 14 15## adminManager.enableAdmin 16 17enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, callback: AsyncCallback\<void>): void 18 19激活当前用户下的指定设备管理员应用，使用Callback形式返回是否激活成功。其中超级管理员应用只能在管理员用户下激活。 20 21**需要权限：** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN 22 23**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 24 25**系统API**: 此接口为系统接口。 26 27**参数**： 28 29| 参数名 | 类型 | 必填 | 说明 | 30| -------------- | ----------------------------------- | ---- | ------------------ | 31| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 32| enterpriseInfo | [EnterpriseInfo](#enterpriseinfo) | 是 | 设备管理员应用的企业信息。 | 33| type | [AdminType](#admintype) | 是 | 激活的设备管理员类型。 | 34| callback | AsyncCallback\<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 35 36**错误码**： 37 38以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 39 40| 错误码ID | 错误信息 | 41| ------- | --------------------------------------------------------------- | 42| 9200003 | the administrator ability component is invalid. | 43| 9200004 | failed to enable the administrator application of the device. | 44| 9200007 | the system ability work abnormally. | 45 46**示例**： 47 48```js 49let wantTemp = { 50 bundleName: "com.example.myapplication", 51 abilityName: "com.example.myapplication.MainAbility", 52}; 53let enterpriseInfo = { 54 name: "enterprise name", 55 description: "enterprise description" 56} 57adminManager.enableAdmin(wantTemp, enterpriseInfo, adminManager.AdminType.ADMIN_TYPE_NORMAL, error => { 58 if (error != null) { 59 console.log("error occurs" + error); 60 return; 61 } 62 console.log("enableAdmin success"); 63}); 64``` 65 66## adminManager.enableAdmin 67 68enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId: number, callback: AsyncCallback\<void>): void 69 70激活指定用户下的指定设备管理员应用，使用callback形式返回是否激活成功。其中超级管理员应用只能在管理员用户下被激活。 71 72**需要权限：** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN 73 74**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 75 76**系统API**: 此接口为系统接口。 77 78**参数**： 79 80| 参数名 | 类型 | 必填 | 说明 | 81| -------------- | ----------------------------------- | ---- | ---------------------------- | 82| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 83| enterpriseInfo | [EnterpriseInfo](#enterpriseinfo) | 是 | 设备管理员应用的企业信息。 | 84| type | [AdminType](#admintype) | 是 | 激活的设备管理员类型。 | 85| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 86| callback | AsyncCallback\<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 87 88**错误码**: 89 90以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 91 92| 错误码ID | 错误信息 | 93| ------- | --------------------------------------------------------------- | 94| 9200003 | the administrator ability component is invalid. | 95| 9200004 | failed to enable the administrator application of the device. | 96| 9200007 | the system ability work abnormally. | 97 98**示例**： 99 100```js 101let wantTemp = { 102 bundleName: "com.example.myapplication", 103 abilityName: "com.example.myapplication.MainAbility", 104}; 105let enterpriseInfo = { 106 name: "enterprise name", 107 description: "enterprise description" 108} 109adminManager.enableAdmin(wantTemp, enterpriseInfo, adminManager.AdminType.ADMIN_TYPE_NORMAL, 100, error => { 110 if (error != null) { 111 console.log("error occurs" + error); 112 return; 113 } 114 console.log("enableAdmin success"); 115}); 116``` 117 118## adminManager.enableAdmin 119 120enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId?: number): Promise\<void> 121 122如果调用接口时传入了可选参数userId，则激活指定用户下的指定设备管理员应用，否则激活当前用户下的指定设备管理员应用，使用Promise形式返回是否激活成功。其中超级管理员应用只能在管理员用户下被激活。 123 124**需要权限：** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN 125 126**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 127 128**系统API**: 此接口为系统接口。 129 130**参数**： 131 132| 参数名 | 类型 | 必填 | 说明 | 133| -------------- | ----------------------------------- | ---- | ---------------------------- | 134| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 135| enterpriseInfo | [EnterpriseInfo](#enterpriseinfo) | 是 | 设备管理员应用的企业信息。 | 136| type | [AdminType](#admintype) | 是 | 激活的设备管理员类型。 | 137| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 138 139**返回值：** 140 141| 类型 | 说明 | 142| ----------------- | ----------------- | 143| Promise\<void> | 无返回结果的Promise对象。当激活设备管理员应用失败时会抛出错误对象。 | 144 145**错误码**： 146 147以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 148 149| 错误码ID | 错误信息 | 150| ------- | --------------------------------------------------------------- | 151| 9200003 | the administrator ability component is invalid. | 152| 9200004 | failed to enable the administrator application of the device. | 153| 9200007 | the system ability work abnormally. | 154 155**示例**： 156 157```js 158let wantTemp = { 159 bundleName: "com.example.myapplication", 160 abilityName: "com.example.myapplication.MainAbility", 161}; 162let enterpriseInfo = { 163 name: "enterprise name", 164 description: "enterprise description" 165} 166adminManager.enableAdmin(wantTemp, enterpriseInfo, adminManager.AdminType.ADMIN_TYPE_NORMAL, 100) 167.catch(error => { 168 console.log("error occurs" + error); 169}); 170``` 171 172## adminManager.disableAdmin 173 174disableAdmin(admin: Want, callback: AsyncCallback\<void>): void 175 176将当前用户下的指定普通管理员应用去激活，使用callback形式返回是否去激活成功。 177 178**需要权限：** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN 179 180**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 181 182**系统API**: 此接口为系统接口。 183 184**参数**： 185 186| 参数名 | 类型 | 必填 | 说明 | 187| -------- | ----------------------------------- | ---- | ------------------- | 188| admin | [Want](js-apis-app-ability-want.md) | 是 | 普通设备管理员应用。 | 189| callback | AsyncCallback\<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 190 191**错误码**: 192 193以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 194 195| 错误码ID | 错误信息 | 196| ------- | ----------------------------------------------------------------- | 197| 9200005 | failed to disable the administrator application of the device. | 198 199**示例**： 200 201```js 202let wantTemp = { 203 bundleName: "bundleName", 204 abilityName: "abilityName", 205}; 206adminManager.disableAdmin(wantTemp, error => { 207 if (error != null) { 208 console.log("error occurs" + error); 209 return; 210 } 211 console.log("disableAdmin success "); 212}); 213``` 214 215## adminManager.disableAdmin 216 217disableAdmin(admin: Want, userId: number, callback: AsyncCallback\<void>): void 218 219将指定用户下的指定普通管理员应用去激活，使用callback形式返回是否去激活成功。 220 221**需要权限：** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN 222 223**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 224 225**系统API**: 此接口为系统接口。 226 227**参数**： 228 229| 参数名 | 类型 | 必填 | 说明 | 230| -------- | ----------------------------------- | ---- | ---------------------------- | 231| admin | [Want](js-apis-app-ability-want.md) | 是 | 普通设备管理员应用。 | 232| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 233| callback | AsyncCallback\<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 234 235**错误码**: 236 237以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 238 239| 错误码ID | 错误信息 | 240| ------- | ----------------------------------------------------------------- | 241| 9200005 | failed to disable the administrator application of the device. | 242 243**示例**： 244 245```js 246let wantTemp = { 247 bundleName: "bundleName", 248 abilityName: "abilityName", 249}; 250adminManager.disableAdmin(wantTemp, 100, error => { 251 if (error != null) { 252 console.log("error occurs" + error); 253 return; 254 } 255 console.log("disableAdmin success "); 256}); 257``` 258 259## adminManager.disableAdmin 260 261disableAdmin(admin: Want, userId?: number): Promise\<void> 262 263如果调用接口时传入了可选参数userId，则将指定用户下的指定普通管理员应用去激活，否则将当前用户下的指定普通管理员应用去激活，使用Promise形式返回是否去激活成功。 264 265**需要权限：** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN 266 267**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 268 269**系统API**: 此接口为系统接口。 270 271**参数**： 272 273| 参数名 | 类型 | 必填 | 说明 | 274| ------ | ----------------------------------- | ---- | ---------------------------- | 275| admin | [Want](js-apis-app-ability-want.md) | 是 | 普通设备管理员应用。 | 276| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 277 278**返回值：** 279 280| 类型 | 说明 | 281| ----------------- | ----------------- | 282| Promise\<void> | 无返回结果的Promise对象。当去激活普通管理员应用失败时会抛出错误对象。 | 283 284**错误码**: 285 286以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 287 288| 错误码ID | 错误信息 | 289| ------- | ----------------------------------------------------------------- | 290| 9200005 | failed to disable the administrator application of the device. | 291 292**示例**： 293 294```js 295let wantTemp = { 296 bundleName: "bundleName", 297 abilityName: "abilityName", 298}; 299adminManager.disableAdmin(wantTemp, 100).catch(error => { 300 console.log("error occurs" + error); 301}); 302``` 303 304## adminManager.disableSuperAdmin 305 306disableSuperAdmin(bundleName: String, callback: AsyncCallback\<void>): void 307 308根据bundleName将管理员用户下的超级管理员应用去激活，使用callback形式返回是否去激活成功。 309 310**需要权限：** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN 311 312**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 313 314**系统API**: 此接口为系统接口。 315 316**参数**： 317 318| 参数名 | 类型 | 必填 | 说明 | 319| ---------- | ----------------------- | ---- | ------------------- | 320| bundleName | String | 是 | 超级设备管理员应用的包名。 | 321| callback | AsyncCallback\<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 322 323**错误码**: 324 325以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 326 327| 错误码ID | 错误信息 | 328| ------- | ----------------------------------------------------------------- | 329| 9200005 | failed to disable the administrator application of the device. | 330 331**示例**： 332 333```js 334let bundleName = "com.example.myapplication"; 335adminManager.disableSuperAdmin(bundleName, error => { 336 if (error != null) { 337 console.log("error occurs" + error); 338 return; 339 } 340 console.log("disableSuperAdmin success"); 341}); 342``` 343 344## adminManager.disableSuperAdmin 345 346disableSuperAdmin(bundleName: String): Promise\<void> 347 348根据bundleName将管理员用户下的超级管理员应用去激活，使用Promise形式返回是否去激活成功。 349 350**需要权限：** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN 351 352**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 353 354**系统API**: 此接口为系统接口。 355 356**参数**： 357 358| 参数名 | 类型 | 必填 | 说明 | 359| ---------- | ------ | ---- | ------------ | 360| bundleName | String | 是 | 超级设备管理员应用的包名。 | 361 362**返回值：** 363 364| 类型 | 说明 | 365| ----------------- | ----------------- | 366| Promise\<void> | 无返回结果的Promise对象。当去激活超级管理员应用失败时会抛出错误对象。 | 367 368**错误码**: 369 370以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 371 372| 错误码ID | 错误信息 | 373| ------- | ----------------------------------------------------------------- | 374| 9200005 | failed to disable the administrator application of the device. | 375 376**示例**： 377 378```js 379let bundleName = "com.example.myapplication"; 380adminManager.disableSuperAdmin(bundleName).catch(error => { 381 console.log("error occurs" + error); 382}); 383``` 384 385## adminManager.isAdminEnabled 386 387isAdminEnabled(admin: Want, callback: AsyncCallback\<boolean>): void 388 389查询当前用户下的指定设备管理员应用是否被激活，使用callback形式返回是否处于激活状态。 390 391**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 392 393**系统API**: 此接口为系统接口。 394 395**参数**： 396 397| 参数名 | 类型 | 必填 | 说明 | 398| -------- | ----------------------------------- | ---- | -------------------- | 399| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 400| callback | AsyncCallback\<boolean> | 是 | 回调函数，当接口调用成功，err为null，data为boolean值，true表示当前用户下的指定设备管理员应用被激活，false表示当前用户下的指定设备管理员应用未激活，否则err为错误对象。 | 401 402**示例**： 403 404```js 405let wantTemp = { 406 bundleName: "bundleName", 407 abilityName: "abilityName", 408}; 409adminManager.isAdminEnabled(wantTemp, (error, result) => { 410 if (error != null) { 411 console.log("error occurs" + error); 412 return; 413 } 414 console.log("result is " + result); 415}); 416``` 417 418## adminManager.isAdminEnabled 419 420isAdminEnabled(admin: Want, userId: number, callback: AsyncCallback\<boolean>): void 421 422查询指定用户下的指定设备管理员应用是否被激活，使用callback形式返回是否处于激活状态。 423 424**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 425 426**系统API**: 此接口为系统接口。 427 428**参数**： 429 430| 参数名 | 类型 | 必填 | 说明 | 431| -------- | ----------------------------------- | ---- | ---------------------------- | 432| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 433| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 434| callback | AsyncCallback\<boolean> | 是 | 回调函数，当接口调用成功，err为null，data为boolean值，true表示当前用户下的指定设备管理员应用被激活，false表示当前用户下的指定设备管理员应用未激活，否则err为错误对象。 | 435 436**示例**： 437 438```js 439let wantTemp = { 440 bundleName: "bundleName", 441 abilityName: "abilityName", 442}; 443adminManager.isAdminEnabled(wantTemp, 100, (error, result) => { 444 if (error != null) { 445 console.log("error occurs" + error); 446 return; 447 } 448 console.log("result is " + result); 449}); 450``` 451 452## adminManager.isAdminEnabled 453 454isAdminEnabled(admin: Want, userId?: number): Promise\<boolean> 455 456如果调用接口时传入参数userId，则查询指定用户下的设备管理员应用是否被激活，否则判断当前用户下的设备管理员应用是否被激活，使用Promise形式返回是否处于激活状态。 457 458**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 459 460**系统API**: 此接口为系统接口。 461 462**参数**： 463 464| 参数名 | 类型 | 必填 | 说明 | 465| ------ | ----------------------------------- | ---- | ---------------------------- | 466| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 467| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 468 469**返回值：** 470 471| 类型 | 说明 | 472| ----------------- | ------------------- | 473| Promise\<boolean> | Promise对象, 返回true表示指定的管理员应用被激活，返回false表示指定的管理员应用未激活。| 474 475**示例**： 476 477```js 478let wantTemp = { 479 bundleName: "bundleName", 480 abilityName: "abilityName", 481}; 482adminManager.isAdminEnabled(wantTemp, 100).then((result) => { 483 console.log("result is " + result); 484}).catch(error => { 485 console.log("error occurs" + error); 486}); 487``` 488 489## adminManager.isSuperAdmin 490 491isSuperAdmin(bundleName: String, callback: AsyncCallback\<boolean>): void 492 493根据bundleName查询管理员用户下的超级管理员应用是否被激活，使用callback形式返回是否处于激活状态。 494 495**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 496 497**系统API**: 此接口为系统接口。 498 499**参数**： 500 501| 参数名 | 类型 | 必填 | 说明 | 502| ---------- | ----------------------- | ---- | -------------------- | 503| bundleName | String | 是 | 设备管理员应用。 | 504| callback | AsyncCallback\<boolean> | 是 | 回调函数，当接口调用成功，err为null，data为boolean类型值，true表示当前用户下的指定设备管理员应用被激活，false表示当前用户下的指定设备管理员应用未激活，否则err为错误对象。 | 505 506**示例**： 507 508```js 509let bundleName = "com.example.myapplication"; 510adminManager.isSuperAdmin(bundleName, (error, result) => { 511 if (error != null) { 512 console.log("error occurs" + error); 513 return; 514 } 515 console.log("result is " + result); 516}); 517``` 518 519## adminManager.isSuperAdmin 520 521isSuperAdmin(bundleName: String): Promise\<boolean> 522 523根据bundleName查询管理员用户下的超级管理员应用是否被激活，使用Promise形式返回是否处于激活状态。 524 525**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 526 527**系统API**: 此接口为系统接口。 528 529**参数**： 530 531| 参数名 | 类型 | 必填 | 说明 | 532| ---------- | ------ | ---- | --------- | 533| bundleName | String | 是 | 超级设备管理员应用。 | 534 535**返回值：** 536 537| 错误码ID | 错误信息 | 538| ----------------- | ------------------- | 539| Promise\<boolean> | Promise对象, 返回true表示指定的超级管理员应用被激活，返回false表示指定的超级管理员应用未激活。 | 540 541**示例**： 542 543```js 544let bundleName = "com.example.myapplication"; 545adminManager.isSuperAdmin(bundleName).then((result) => { 546 console.log("result is " + result); 547}).catch(error => { 548 console.log("error occurs" + error); 549}); 550``` 551 552## adminManager.setEnterpriseInfo 553 554setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo, callback: AsyncCallback\<void>;): void 555 556设置指定设备管理员应用的企业信息，使用callback形式返回是否设置成功。 557 558**需要权限：** ohos.permission.SET_ENTERPRISE_INFO 559 560**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 561 562**系统API**: 此接口为系统接口。 563 564**参数：** 565 566| 参数名 | 类型 | 必填 | 说明 | 567| -------------- | ----------------------------------- | ---- | ---------------------- | 568| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 569| enterpriseInfo | [EnterpriseInfo](#enterpriseinfo) | 是 | 设备管理员应用的企业信息。 | 570| callback | AsyncCallback\<void>; | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 571 572**错误码**： 573 574以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 575 576| 错误码ID | 错误信息 | 577| ------- | ----------------------------------------------------- | 578| 9200001 | the application is not an administrator of the device. | 579 580**示例：** 581 582```js 583let wantTemp = { 584 bundleName: "com.example.myapplication", 585 abilityName: "com.example.myapplication.MainAbility", 586}; 587let enterpriseInfo = { 588 name: "enterprise name", 589 description: "enterprise description" 590} 591adminManager.setEnterpriseInfo(wantTemp, enterpriseInfo, error => { 592 if (error != null) { 593 console.log("error occurs" + error); 594 return; 595 } 596 console.log("setEnterpriseInfo success"); 597}); 598``` 599 600## adminManager.setEnterpriseInfo 601 602setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo): Promise\<void>; 603 604设置指定设备管理员应用的企业信息，使用Promise形式返回是否设置成功。 605 606**需要权限：** ohos.permission.SET_ENTERPRISE_INFO 607 608**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 609 610**系统API**: 此接口为系统接口。 611 612**参数：** 613 614| 参数名 | 类型 | 必填 | 说明 | 615| -------------- | ----------------------------------- | ---- | ------------ | 616| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用 | 617| enterpriseInfo | [EnterpriseInfo](#enterpriseinfo) | 是 | 设备管理员应用的企业信息 | 618 619**返回值：** 620 621| 类型 | 说明 | 622| ----------------- | --------------------- | 623| Promise\<void> | 无返回结果的Promise对象。当设置设备管理员应用企业信息失败时会抛出错误对象。 | 624 625**错误码**： 626 627以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 628 629| 错误码ID | 错误信息 | 630| ------- | ----------------------------------------------------- | 631| 9200001 | the application is not an administrator of the device. | 632 633**示例：** 634 635```js 636let wantTemp = { 637 bundleName: "com.example.myapplication", 638 abilityName: "com.example.myapplication.MainAbility", 639}; 640let enterpriseInfo = { 641 name: "enterprise name", 642 description: "enterprise description" 643} 644adminManager.setEnterpriseInfo(wantTemp, enterpriseInfo).catch(error => { 645 console.log("error occurs" + error); 646}); 647``` 648 649## adminManager.getEnterpriseInfo 650 651getEnterpriseInfo(admin: Want, callback: AsyncCallback<EnterpriseInfo>): void 652 653获取指定设备管理员应用的企业信息，使用callback形式返回设备管理员应用的企业信息。 654 655**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 656 657**系统API**: 此接口为系统接口。 658 659**参数：** 660 661| 参数名 | 类型 | 必填 | 说明 | 662| -------- | ---------------------------------------- | ---- | ------------------------ | 663| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用 | 664| callback | AsyncCallback<[EnterpriseInfo](#enterpriseinfo)> | 是 | 回调函数，当接口调用成功，err为null，data为设备管理员应用的企业信息，否则err为错误对象。 | 665 666**错误码**： 667 668以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 669 670| 错误码ID | 错误信息 | 671| ------- | ----------------------------------------------------- | 672| 9200001 | the application is not an administrator of the device. | 673 674**示例：** 675 676```js 677let wantTemp = { 678 bundleName: "com.example.myapplication", 679 abilityName: "com.example.myapplication.MainAbility", 680}; 681adminManager.getEnterpriseInfo(wantTemp, (error, result) => { 682 if (error != null) { 683 console.log("error occurs" + error); 684 return; 685 } 686 console.log(result.name); 687 console.log(result.description); 688}); 689``` 690 691## adminManager.getEnterpriseInfo 692 693getEnterpriseInfo(admin: Want): Promise<EnterpriseInfo> 694 695获取指定设备管理员应用的企业信息，使用Promise形式返回设备管理员应用的企业信息。 696 697**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 698 699**系统API**: 此接口为系统接口。 700 701**参数：** 702 703| 参数名 | 类型 | 必填 | 说明 | 704| ----- | ----------------------------------- | ---- | ------- | 705| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用 | 706 707**返回值：** 708 709| 类型 | 说明 | 710| ---------------------------------------- | ------------------------- | 711| Promise<[EnterpriseInfo](#enterpriseinfo)> | Promise对象，返回指定设备管理员应用的企业信息。 | 712 713**错误码**： 714 715以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 716 717| 错误码ID | 错误信息 | 718| ------- | ----------------------------------------------------- | 719| 9200001 | the application is not an administrator of the device. | 720 721**示例：** 722 723```js 724let wantTemp = { 725 bundleName: "com.example.myapplication", 726 abilityName: "com.example.myapplication.MainAbility", 727}; 728adminManager.getEnterpriseInfo(wantTemp).then((result) => { 729 console.log(result.name); 730 console.log(result.description); 731}).catch(error => { 732 console.log("error occurs" + error); 733}); 734``` 735 736## adminManager.subscribeManagedEvent 737 738subscribeManagedEvent(admin: Want, managedEvents: Array\<ManagedEvent>, callback: AsyncCallback\<void>): void 739 740指定设备管理员应用订阅系统管理事件。使用callback形式返回结果。 741 742**需要权限：** ohos.permission.ENTERPRISE_SUBSCRIBE_MANAGED_EVENT 743 744**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 745 746**系统API**: 此接口为系统接口。 747 748**参数：** 749 750| 参数名 | 类型 | 必填 | 说明 | 751| ----- | ----------------------------------- | ---- | ------- | 752| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 753| managedEvents | Array\<[ManagedEvent](#managedevent)> | 是 | 订阅事件数组。 | 754| callback | AsyncCallback\<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 755 756**错误码**： 757 758以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 759 760|错误码ID | 错误信息 | 761| ------- | ----------------------------------------------------- | 762| 9200001 | the application is not an administrator of the device. | 763| 9200008 | the specified system events enum is invalid. | 764 765**示例：** 766 767```js 768let wantTemp = { 769 bundleName: "bundleName", 770 abilityName: "abilityName", 771}; 772let events = [0, 1]; 773adminManager.subscribeManagedEvent(wantTemp, events, (error) => { 774 if (error) { 775 console.log("error code:" + error.code + " error message:" + error.message); 776 } 777}); 778``` 779 780## adminManager.subscribeManagedEvent 781 782subscribeManagedEvent(admin: Want, managedEvents: Array\<ManagedEvent>): Promise\<void> 783 784指定设备管理员应用订阅系统管理事件。使用Promise形式返回结果。 785 786**需要权限：** ohos.permission.ENTERPRISE_SUBSCRIBE_MANAGED_EVENT 787 788**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 789 790**系统API**: 此接口为系统接口。 791 792**参数：** 793 794| 参数名 | 类型 | 必填 | 说明 | 795| ----- | ----------------------------------- | ---- | ------- | 796| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 797| managedEvents | Array\<[ManagedEvent](#managedevent)> | 是 | 订阅事件数组。 | 798 799**返回值：** 800 801| 类型 | 说明 | 802| ----- | ----------------------------------- | 803| Promise\<void> | 无返回结果的Promise对象。当指定设备管理员应用订阅系统事件失败时会抛出错误对象。 | 804 805**错误码**： 806 807以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 808 809| 错误码ID | 错误信息 | 810| ------- | ----------------------------------------------------- | 811| 9200001 | the application is not an administrator of the device. | 812| 9200008 | the specified system events enum is invalid. | 813 814**示例：** 815 816```js 817let wantTemp = { 818 bundleName: "bundleName", 819 abilityName: "abilityName", 820}; 821let events = [0, 1]; 822adminManager.subscribeManagedEvent(wantTemp, events).then(() => { 823}).catch((error) => { 824 console.log("error code:" + error.code + " error message:" + error.message); 825}) 826``` 827 828## adminManager.unsubscribeManagedEvent 829 830unsubscribeManagedEvent(admin: Want, managedEvents: Array\<ManagedEvent>, callback: AsyncCallback\<void>): void 831 832指定设备管理员应用取消订阅系统管理事件。使用callback形式返回结果。 833 834**需要权限：** ohos.permission.ENTERPRISE_SUBSCRIBE_MANAGED_EVENT 835 836**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 837 838**系统API**: 此接口为系统接口。 839 840**参数：** 841 842| 参数名 | 类型 | 必填 | 说明 | 843| ----- | ----------------------------------- | ---- | ------- | 844| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 845| managedEvents | Array\<[ManagedEvent](#managedevent)> | 是 | 取消订阅事件数组。 | 846| callback | AsyncCallback\<void> | 是 | 回调函数，当接口调用成功，err为null，否则为错误对象。 | 847 848**错误码**： 849 850以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 851 852| 错误码ID | 错误信息 | 853| ------- | ----------------------------------------------------- | 854| 9200001 | the application is not an administrator of the device. | 855| 9200008 | the specified system events enum is invalid. | 856 857**示例：** 858 859```js 860let wantTemp = { 861 bundleName: "bundleName", 862 abilityName: "abilityName", 863}; 864let events = [0, 1]; 865adminManager.unsubscribeManagedEvent(wantTemp, events, (error) => { 866 if (error) { 867 console.log("error code:" + error.code + " error message:" + error.message); 868 } 869}); 870``` 871 872## adminManager.unsubscribeManagedEvent 873 874unsubscribeManagedEvent(admin: Want, managedEvents: Array\<ManagedEvent>): Promise\<void> 875 876指定设备管理员应用取消订阅系统管理事件。使用Promise形式返回结果。 877 878**需要权限：** ohos.permission.ENTERPRISE_SUBSCRIBE_MANAGED_EVENT 879 880**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 881 882**系统API**: 此接口为系统接口。 883 884**参数：** 885 886| 参数名 | 类型 | 必填 | 说明 | 887| ----- | ----------------------------------- | ---- | ------- | 888| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | 889| managedEvents | Array\<[ManagedEvent](#managedevent)> | 是 | 取消订阅事件数组。 | 890 891**返回值：** 892 893| 类型 | 说明 | 894| ----- | ----------------------------------- | 895| Promise\<void> | 无返回结果的Promise对象。当指定设备管理员应用取消订阅系统管理时间失败时会抛出错误对象。 | 896 897**错误码**： 898 899以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) 900 901| 错误码ID | 错误信息 | 902| ------- | ----------------------------------------------------- | 903| 9200001 | the application is not an administrator of the device. | 904| 9200008 | the specified system events enum is invalid. | 905 906**示例：** 907 908```js 909let wantTemp = { 910 bundleName: "bundleName", 911 abilityName: "abilityName", 912}; 913let events = [0, 1]; 914adminManager.unsubscribeManagedEvent(wantTemp, events).then(() => { 915}).catch((error) => { 916 console.log("error code:" + error.code + " error message:" + error.message); 917}) 918``` 919 920## EnterpriseInfo 921 922设备管理员应用的企业信息 923 924**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 925 926**系统API**: 此接口为系统接口。 927 928| 名称 | 类型 | 可读 | 可写 | 说明 | 929| ----------- | --------| ---- | ----- | ------------------------------- | 930| name | string | 是 | 否 | 表示设备管理员应用所属企业的名称。 | 931| description | string | 是 | 否 | 表示设备管理员应用所属企业的描述。 | 932 933## AdminType 934 935设备管理员应用的管理员类型。 936 937**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 938 939**系统API**: 此接口为系统接口。 940 941| 名称 | 值 | 说明 | 942| ----------------- | ---- | ----- | 943| ADMIN_TYPE_NORMAL | 0x00 | 普通管理员 | 944| ADMIN_TYPE_SUPER | 0x01 | 超级管理员 | 945 946## ManagedEvent 947 948可订阅系统管理事件。 949 950**系统能力：** SystemCapability.Customization.EnterpriseDeviceManager 951 952**系统API**: 此接口为系统接口。 953 954| 名称 | 值 | 说明 | 955| -------------------------- | ---- | ------------- | 956| MANAGED_EVENT_BUNDLE_ADDED | 0 | 应用安装事件。 | 957| MANAGED_EVENT_BUNDLE_REMOVED | 1 | 应用卸载事件。 | 958 959