From 5454884ee023beaad48c82c359923a23a06da9f6 Mon Sep 17 00:00:00 2001 From: ning Date: Wed, 18 Dec 2024 14:10:29 +0000 Subject: [PATCH] update api/@ohos.enterprise.adminManager.d.ts. Signed-off-by: ning --- api/@ohos.enterprise.adminManager.d.ts | 116 ++++++++++++++++++------- 1 file changed, 85 insertions(+), 31 deletions(-) diff --git a/api/@ohos.enterprise.adminManager.d.ts b/api/@ohos.enterprise.adminManager.d.ts index 2ee8bdbcf..3fe840ab2 100644 --- a/api/@ohos.enterprise.adminManager.d.ts +++ b/api/@ohos.enterprise.adminManager.d.ts @@ -19,7 +19,6 @@ */ import type { AsyncCallback } from './@ohos.base'; - import type Want from './@ohos.app.ability.Want'; /** @@ -58,7 +57,7 @@ declare namespace adminManager { * @since 9 */ description: string; - } + } /** * Enum for type of administrator. @@ -86,7 +85,7 @@ declare namespace adminManager { * @since 9 */ ADMIN_TYPE_SUPER = 0x01 - } + } /** * Enum for managed event @@ -159,7 +158,7 @@ declare namespace adminManager { * @since 16 */ MANAGED_EVENT_ACCOUNT_REMOVED = 7 - } + } /** * Enables the given ability as a administrator of the device. @@ -180,7 +179,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, callback: AsyncCallback): void; @@ -205,7 +204,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId: number, callback: AsyncCallback): void; @@ -230,7 +229,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId?: number): Promise; @@ -250,7 +249,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function disableAdmin(admin: Want, callback: AsyncCallback): void; @@ -271,7 +270,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function disableAdmin(admin: Want, userId: number, callback: AsyncCallback): void; @@ -290,7 +289,7 @@ declare namespace adminManager { * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager - * @StageModelOnly + * @stagemodelonly * @since 12 */ function disableAdmin(admin: Want, userId?: number): Promise; @@ -309,7 +308,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function disableSuperAdmin(bundleName: String, callback: AsyncCallback): void; @@ -328,7 +327,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function disableSuperAdmin(bundleName: String): Promise; @@ -343,7 +342,7 @@ declare namespace adminManager { * 2. Incorrect parameter types. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function isAdminEnabled(admin: Want, callback: AsyncCallback): void; @@ -359,7 +358,7 @@ declare namespace adminManager { * 2. Incorrect parameter types. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function isAdminEnabled(admin: Want, userId: number, callback: AsyncCallback): void; @@ -375,7 +374,7 @@ declare namespace adminManager { * 2. Incorrect parameter types. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function isAdminEnabled(admin: Want, userId?: number): Promise; @@ -391,7 +390,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function getEnterpriseInfo(admin: Want, callback: AsyncCallback): void; @@ -407,7 +406,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function getEnterpriseInfo(admin: Want): Promise; @@ -427,7 +426,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo, callback: AsyncCallback): void; @@ -447,7 +446,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo): Promise; @@ -462,7 +461,7 @@ declare namespace adminManager { * 2. Incorrect parameter types. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function isSuperAdmin(bundleName: String, callback: AsyncCallback): void; @@ -477,7 +476,7 @@ declare namespace adminManager { * 2. Incorrect parameter types. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function isSuperAdmin(bundleName: String): Promise; @@ -497,7 +496,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function subscribeManagedEvent(admin: Want, managedEvents: Array, callback: AsyncCallback): void; @@ -517,7 +516,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function subscribeManagedEvent(admin: Want, managedEvents: Array): Promise; @@ -537,7 +536,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function unsubscribeManagedEvent(admin: Want, managedEvents: Array, callback: AsyncCallback): void; @@ -557,7 +556,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 9 */ function unsubscribeManagedEvent(admin: Want, managedEvents: Array): Promise; @@ -578,7 +577,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 10 */ function authorizeAdmin(admin: Want, bundleName: string, callback: AsyncCallback): void; @@ -599,7 +598,7 @@ declare namespace adminManager { * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 10 */ function authorizeAdmin(admin: Want, bundleName: string): Promise; @@ -611,7 +610,7 @@ declare namespace adminManager { * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. * @syscap SystemCapability.Customization.EnterpriseDeviceManager * @systemapi - * @StageModelOnly + * @stagemodelonly * @since 12 */ function getSuperAdmin(): Promise; @@ -628,7 +627,7 @@ declare namespace adminManager { * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager - * @StageModelOnly + * @stagemodelonly * @since 12 */ function subscribeManagedEventSync(admin: Want, managedEvents: Array): void; @@ -645,10 +644,65 @@ declare namespace adminManager { * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; * 2. Incorrect parameter types; 3. Parameter verification failed. * @syscap SystemCapability.Customization.EnterpriseDeviceManager - * @StageModelOnly + * @stagemodelonly * @since 12 */ function unsubscribeManagedEventSync(admin: Want, managedEvents: Array): void; + + /** + * Administrator delegates access to policies to another application. + * + * @permission ohos.permission.ENTERPRISE_MANAGE_DELEGATED_POLICY + * @param { Want } admin - admin indicates the administrator ability information. + * @param { string } bundleName - bundleName indicates the bundle name of the delegated application. + * @param { Array } policies - policies indicates the policies accessible to the delegated application. + * @throws { BusinessError } 9200001 - The application is not an administrator application of the device. + * @throws { BusinessError } 9200002 - The administrator application does not have permission to manage the device. + * @throws { BusinessError } 9200009 - Failed to grant the permission to the application. + * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. + * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; + * 2. Incorrect parameter types; 3. Parameter verification failed. + * @syscap SystemCapability.Customization.EnterpriseDeviceManager + * @stagemodelonly + * @since 14 + */ + function setDelegatedPolicies(admin: Want, bundleName: string, policies: Array): void; + + /** + * Administrator gets the list of delegation policies for the application. + * + * @permission ohos.permission.ENTERPRISE_MANAGE_DELEGATED_POLICY + * @param { Want } admin - admin indicates the administrator ability information. + * @param { string } bundleName - bundleName indicates the bundle name of the delegated application. + * @returns { Array } the policies accessible to the delegated application. + * @throws { BusinessError } 9200001 - The application is not an administrator application of the device. + * @throws { BusinessError } 9200002 - The administrator application does not have permission to manage the device. + * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. + * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; + * 2. Incorrect parameter types; 3. Parameter verification failed. + * @syscap SystemCapability.Customization.EnterpriseDeviceManager + * @stagemodelonly + * @since 14 + */ + function getDelegatedPolicies(admin: Want, bundleName: string): Array; + + /** + * Administrator gets the delegated applications which access to the policy. + * + * @permission ohos.permission.ENTERPRISE_MANAGE_DELEGATED_POLICY + * @param { Want } admin - admin indicates the administrator ability information. + * @param { string } policy - policy indicates the policy that delegated to other applications. + * @returns { Array } the bundle names of the delegated application that access to the policy. + * @throws { BusinessError } 9200001 - The application is not an administrator application of the device. + * @throws { BusinessError } 9200002 - The administrator application does not have permission to manage the device. + * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. + * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; + * 2. Incorrect parameter types; 3. Parameter verification failed. + * @syscap SystemCapability.Customization.EnterpriseDeviceManager + * @stagemodelonly + * @since 14 + */ + function getDelegatedBundleNames(admin: Want, policy: string): Array; } -export default adminManager; \ No newline at end of file +export default adminManager; -- Gitee