diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md index ed47bd174994dc8a1f9ed712b836f3c5bc0d1be1..1fb8c5e88895f684445bace3a5e6287433071f73 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md @@ -943,6 +943,102 @@ adminManager.unsubscribeManagedEvent(wantTemp, events).then(() => { }) ``` +## adminManager.authorizeAdmin10+ + +authorizeAdmin(admin: Want, bundleName: string, callback: AsyncCallback<void>): void + +设备管理应用授予指定应用管理员权限。使用callback异步回调。 + +**需要权限:** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN + +**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | +| bundleName | string | 是 | 被授予管理员权限应用的包名。 | +| callback | AsyncCallback<void> | 是 | 回调函数,当接口调用成功,err为null,否则为错误对象。 | + +**错误码**: + +以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) + +| 错误码ID | 错误信息 | +| ------- | ----------------------------------------------------- | +| 9200001 | the application is not an administrator of the device. | +| 9200002 | the administrator application does not have permission to manage the device. | +| 9200009 | authorize permission to the application failed. | + +**示例:** + +```js +let wantTemp = { + bundleName: 'bundleName', + abilityName: 'abilityName', +}; +let bundleName: string = "com.example.application"; +adminManager.authorizeAdmin(wantTemp, bundleName, (err) => { + if (err) { + console.error(`Failed to authorize permission to the application. Code: ${err.code}, message: ${err.message}`); + return; + } + console.info('Successfully authorized permission to the application'); +}); +``` + +## adminManager.authorizeAdmin10+ + +authorizeAdmin(admin: Want, bundleName: string): Promise<void> + +设备管理应用授予指定应用管理员权限。使用Promise异步回调。 + +**需要权限:** ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN + +**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager + +**系统API**: 此接口为系统接口。 + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ----------------------------------- | ---- | ------- | +| admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理应用。 | +| bundleName | string | 是 | 被授予管理员权限应用的包名。 | + +**返回值:** + +| 类型 | 说明 | +| ----- | ----------------------------------- | +| Promise<void> | 无返回结果的Promise对象。当设备管理应用授予指定应用管理员权限失败时,抛出错误对象。 | + +**错误码**: + +以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) + +| 错误码ID | 错误信息 | +| ------- | ----------------------------------------------------- | +| 9200001 | the application is not an administrator of the device. | +| 9200002 | the administrator application does not have permission to manage the device. | +| 9200009 | authorize permission to the application failed. | + +**示例:** + +```js +let wantTemp = { + bundleName: 'bundleName', + abilityName: 'abilityName', +}; +let bundleName: string = "com.example.application"; +adminManager.authorizeAdmin(wantTemp, bundleName).then(() => { +}).catch((err) => { + console.error(`Failed to authorize permission to the application. Code: ${err.code}, message: ${err.message}`); +}) +``` + ## EnterpriseInfo 设备管理应用的企业信息。 diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-enterpriseDeviceManager.md b/zh-cn/application-dev/reference/errorcodes/errorcode-enterpriseDeviceManager.md index d44bae35cadf409fed2557018602e56501329a3a..51bb2e0a3470a2e0e2a935384897bf7182db66f2 100644 --- a/zh-cn/application-dev/reference/errorcodes/errorcode-enterpriseDeviceManager.md +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-enterpriseDeviceManager.md @@ -165,4 +165,22 @@ The specified system events enum is invalid. **处理步骤** -检查所订阅事件是企业设备管理所支持的有效管理事件。 \ No newline at end of file +检查所订阅事件是企业设备管理所支持的有效管理事件。 + +## 9200009 授予应用权限失败 + +**错误信息** + +Authorize permission to the application failed. + +**错误描述** + +当超级设备管理应用授予其他应用管理员权限失败时,则会产生此错误码。 + +**可能原因** + +被授予权限的应用未在管理员用户下安装。 + +**处理步骤** + +检查需要被授予权限的应用是否在管理员用户下安装。