当前位置： 首页 > news >正文

鸿蒙开发接口定制管理：【@ohos.enterpriseDeviceManager (企业设备管理)】

news 2025/7/3 10:25:11

企业设备管理

说明：

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import enterpriseDeviceManager from '@ohos.enterpriseDeviceManager';

enterpriseDeviceManager.activateAdmin

activateAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, callback: AsyncCallback): void

以异步方法根据给定的包名和类名激活设备管理员应用，使用Callback形式返回是否激活成功。

需要权限：  ohos.permission.MANAGE_ADMIN

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是设备管理员应用
enterpriseInfo[EnterpriseInfo]是设备管理员应用的企业信息
type[AdminType]是激活的设备管理员类型
callbackAsyncCallback是callback方式返回是否激活成功

示例：

let wantTemp = {bundleName: "com.example.myapplication",abilityName: "com.example.myapplication.MainAbility",
};
let enterpriseInfo = {name: "enterprise name",description: "enterprise description"
}
enterpriseDeviceManager.activateAdmin(wantTemp, enterpriseInfo, enterpriseDeviceManager.AdminType.ADMIN_TYPE_NORMAL, (error, result) => {if (error != null) {console.log("error occurs" + error);return; }console.log("result is " + result);
});

enterpriseDeviceManager.activateAdmin

activateAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType): Promise

以异步方法根据给定的包名和类名激活设备管理员应用，使用Promise形式返回是否激活成功。

需要权限：  ohos.permission.MANAGE_ADMIN

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是设备管理员应用
enterpriseInfo[EnterpriseInfo]是设备管理员应用的企业信息
type[AdminType]是激活的设备管理员类型

返回值：

类型说明
PromisePromise形式返回是否激活成功

示例：

let wantTemp = {bundleName: "com.example.myapplication",abilityName: "com.example.myapplication.MainAbility",
};
let enterpriseInfo = {name: "enterprise name",description: "enterprise description"
}
enterpriseDeviceManager.activateAdmin(wantTemp, enterpriseInfo, enterpriseDeviceManager.AdminType.ADMIN_TYPE_NORMAL)
.then((result) => {console.log("result is " + result);
}).catch(error => {console.log("error occurs" + error);
});

enterpriseDeviceManager.deactivateAdmin

deactivateAdmin(admin: Want, callback: AsyncCallback): void

以异步方法根据给定的包名和类名将设备普通管理员应用去激活，使用Callback形式返回是否去激活成功。

需要权限：  ohos.permission.MANAGE_ADMIN

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是普通设备管理员应用
callbackAsyncCallback是callback方式返回是否去激活成功

示例：

let wantTemp = {bundleName: "bundleName",abilityName: "abilityName",
};
enterpriseDeviceManager.deactivateAdmin(wantTemp, (error, result) => {if (error != null) {console.log("error occurs" + error);return; }console.log("result is " + result);
});

enterpriseDeviceManager.deactivateAdmin

deactivateAdmin(admin: Want): Promise

以异步方法根据给定的包名和类名将设备普通管理员应用去激活，使用Promise形式返回是否去激活成功。

需要权限：  ohos.permission.MANAGE_ADMIN

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是普通设备管理员应用

返回值：

类型说明
PromisePromise形式返回是否激活成功

示例：

let wantTemp = {bundleName: "bundleName",abilityName: "abilityName",
};
enterpriseDeviceManager.deactivateAdmin(wantTemp).then((result) => {console.log("result is " + result);
}).catch(error => {console.log("error occurs" + error);
});

enterpriseDeviceManager.deactivateSuperAdmin

deactivateSuperAdmin(bundleName: String, callback: AsyncCallback): void

以异步方法根据给定的包名将设备超级管理员应用去激活，使用Callback形式返回是否去激活成功。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
bundleNameString是超级设备管理员应用的包名
callbackAsyncCallback是callback方式返回是否去激活成功

示例：

let bundleName = "com.example.myapplication";
enterpriseDeviceManager.deactivateSuperAdmin(bundleName, (error, result) => {if (error != null) {console.log("error occurs" + error);return; }console.log("result is " + result);
});

enterpriseDeviceManager.deactivateSuperAdmin

deactivateSuperAdmin(bundleName: String): Promise

以异步方法根据给定的包名将设备超级管理员应用去激活，使用Promise形式返回是否去激活成功。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
bundleNameString是超级设备管理员应用的包名

返回值：

类型说明
PromisePromise形式返回是否激活成功

示例：

let bundleName = "com.example.myapplication";
enterpriseDeviceManager.deactivateSuperAdmin(bundleName).then((result) => {console.log("result is " + result);
}).catch(error => {console.log("error occurs" + error);
});

enterpriseDeviceManager.isAdminAppActive

isAdminAppActive(admin: Want, callback: AsyncCallback): void

以异步方法根据给定的包名和类名判断设备管理员应用是否被激活，使用Callback形式返回是否处于激活状态。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是设备管理员应用
callbackAsyncCallback是callback方式返回是否处于激活状态

示例：

let wantTemp = {bundleName: "bundleName",abilityName: "abilityName",
};
enterpriseDeviceManager.isAdminAppActive(wantTemp, (error, result) => {if (error != null) {console.log("error occurs" + error);return; }console.log("result is " + result);
});

enterpriseDeviceManager.isAdminAppActive

isAdminAppActive(admin: Want): Promise

以异步方法根据给定的包名和类名判断设备管理员应用是否被激活，使用Promise形式返回是否处于激活状态。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是设备管理员应用

返回值：

类型说明
PromisePromise形式返回是否处于激活状态

示例：

let wantTemp = {bundleName: "bundleName",abilityName: "abilityName",
};
enterpriseDeviceManager.isAdminAppActive(wantTemp).then((result) => {console.log("result is " + result);
}).catch(error => {console.log("error occurs" + error);
});

enterpriseDeviceManager.isSuperAdmin

isSuperAdmin(bundleName: String, callback: AsyncCallback): void

以异步方法根据给定的包名判断设备超级管理员应用是否被激活，使用Callback形式返回是否处于激活状态。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
bundleNameString是设备管理员应用
callbackAsyncCallback是callback方式返回是否处于激活状态

示例：

let bundleName = "com.example.myapplication";
enterpriseDeviceManager.isSuperAdmin(bundleName, (error, result) => {if (error != null) {console.log("error occurs" + error);return; }console.log("result is " + result);
});

enterpriseDeviceManager.isSuperAdmin

isSuperAdmin(bundleName: String): Promise

以异步方法根据给定的包名判断设备超级管理员应用是否被激活，使用Promise形式返回是否处于激活状态。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
bundleNameString是超级设备管理员应用

返回值：

类型说明
PromisePromise形式返回是否处于激活状态

示例：

let bundleName = "com.example.myapplication";
enterpriseDeviceManager.isSuperAdmin(bundleName).then((result) => {console.log("result is " + result);
}).catch(error => {console.log("error occurs" + error);
});

enterpriseDeviceManager.getDeviceSettingsManager

getDeviceSettingsManager(callback: AsyncCallback): void

获取DeviceSettingsManager对象，使用callback形式返回DeviceSettingsManager对象。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
callbackAsyncCallback是callback方式返回DeviceSettingsManager对象

示例：

let wantTemp = {bundleName: "bundleName",abilityName: "abilityName",
};
enterpriseDeviceManager.getDeviceSettingsManager((error, mgr) => {if (error != null) {console.log("error occurs" + error);return; }mgr.setDateTime(wantTemp, 1526003846000, (error, value) => { if (error != null) {console.log(error);} else {console.log(value);}});
});

enterpriseDeviceManager.getDeviceSettingsManager

getDeviceSettingsManager(): Promise

获取DeviceSettingsManager对象，使用Promise形式返回DeviceSettingsManager对象。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

返回值：

类型说明
PromisePromise方式返回DeviceSettingsManager对象

示例：

let wantTemp = {bundleName: "bundleName",abilityName: "abilityName",
};
mgr.getDeviceSettingsManager().then((mgr) => {mgr.setDateTime(wantTemp, 1526003846000).then((value) => {console.log(value);}).catch((error) => {console.log(error);})
}).catch((error) => {console.log(error);
})

enterpriseDeviceManager.setEnterpriseInfo

setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo, callback: AsyncCallback): void

设置设备管理员应用的企业信息，使用callback形式返回是否设置成功。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是设备管理员应用
enterpriseInfo[EnterpriseInfo]是设备管理员应用的企业信息
callbackAsyncCallback是callback方式返回是否设置企业信息成功

示例：

let wantTemp = {bundleName: "com.example.myapplication",abilityName: "com.example.myapplication.MainAbility",
};
let enterpriseInfo = {name: "enterprise name",description: "enterprise description"
}
enterpriseDeviceManager.setEnterpriseInfo(wantTemp, enterpriseInfo)
.then((result) => {console.log("result is " + result);
}).catch(error => {console.log("error occurs" + error);
});

enterpriseDeviceManager.setEnterpriseInfo

setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo): Promise

设置设备管理员应用的企业信息，使用Promise形式返回是否设置成功。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是设备管理员应用
enterpriseInfo[EnterpriseInfo]是设备管理员应用的企业信息

返回值：

类型说明
Promise;Promise方式返回是否设置企业信息成功

示例：

let wantTemp = {bundleName: "com.example.myapplication",abilityName: "com.example.myapplication.MainAbility",
};
let enterpriseInfo = {name: "enterprise name",description: "enterprise description"
}
enterpriseDeviceManager.setEnterpriseInfo(wantTemp, enterpriseInfo)
.then((result) => {console.log("result is " + result);
}).catch(error => {console.log("error occurs" + error);
});

enterpriseDeviceManager.getEnterpriseInfo

getEnterpriseInfo(admin: Want, callback: AsyncCallback): void

获取设备管理员应用的企业信息，使用callback形式返回设备管理员应用的企业信息。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是设备管理员应用
callbackAsyncCallback<[EnterpriseInfo]>是callback方式返回设备管理员应用的企业信息

示例：

let wantTemp = {bundleName: "com.example.myapplication",abilityName: "com.example.myapplication.MainAbility",
};
enterpriseDeviceManager.getEnterpriseInfo(wantTemp, (error, result) => {if (error != null) {console.log("error occurs" + error);return; }console.log(result.name);console.log(result.description);
});

enterpriseDeviceManager.getEnterpriseInfo

getEnterpriseInfo(admin: Want): Promise

获取设备管理员应用的企业信息，使用Promise形式返回设备管理员应用的企业信息。

系统能力：  SystemCapability.Customation.EnterpriseDeviceManager

参数：

参数名类型必填说明
admin[Want]是设备管理员应用

返回值：

类型说明
Promise<[EnterpriseInfo]>Promise方式返回设备管理员应用的企业信息对象

示例：

let wantTemp = {bundleName: "com.example.myapplication",abilityName: "com.example.myapplication.MainAbility",
};
enterpriseDeviceManager.getEnterpriseInfo(wantTemp).then((result) => {console.log(result.name);console.log(result.description);
}).catch(error => {console.log("error occurs" + error);
});

EnterpriseInfo

设备管理员应用的企业信息

系统能力：  以下各项对应系统能力均为SystemCapability.Customation.EnterpriseDeviceManager

名称读写属性类型必填描述
name只读string是表示设备管理员应用所属企业的名称。
description只读string是表示设备管理员应用所属企业的描述。

AdminType

设备管理员应用的管理员类型。

系统能力：  以下各项对应系统能力均为SystemCapability.Customation.EnterpriseDeviceManager

名称默认值说明
ADMIN_TYPE_NORMAL0x00普通管理员
ADMIN_TYPE_SUPER0x01超级管理员
http://www.lryc.cn/news/362729.html

相关文章：

  • Pytorch实用教程：多分类任务中使用的交叉熵损失函数nn.CrossEntropyLoss
  • 智慧冶金：TSINGSEE青犀AI+视频技术助力打造高效、安全的生产环境
  • 【ARM+Codesys案例】基于全志T3+Codesys软PLC的3C点胶边缘控制解决方案：整合了运动控制、视觉、激光测高等技术
  • 描述JSP的内置对象
  • MongoDB CRUD操作：可重试写入
  • Microsoft Outlook Lite 引入短信功能
  • Redis的数据结构以及对应的使用场景
  • Vue中如何获取dom元素？
  • 前端最新面试题(基础模块HTML/CSS/JS篇)
  • matlab模拟太阳耀斑喷发
  • WebStorm 2024.1.1 Mac激活码 前端开发工具集成开发环境（IDE）
  • 多项目的.net core解决方案（项目间引用）如何使用Docker部署
  • 使用raise语句抛出异常
  • vue组件中data为什么必须是一个函数？
  • 10-Django项目--Ajax请求
  • 二进制安装Prometheus
  • Git配置SSH-Key
  • 处理多语言文案的工具
  • 手把手教你MMDetection实战
  • C++的爬山算法
  • Lumière：开创性的视频生成模型及其应用
  • MySQL：MySQL的EXPLAIN各字段含义详解
  • 域内路由选择协议——RIP
  • JVM学习-MAT
  • 高通Android 12/13实现USB拔出关机功能
  • 用Python打造你的微博热搜追踪器
  • TypeScript 在前端开发中的应用
  • 【ArcGIS微课1000例】0115：字段数据类型案例详解
  • ABC318-D
  • Java实现线程安全的单例模式