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


    企业设备管理

    说明:

    本模块首批接口从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]激活的设备管理员类型
    callbackAsyncCallbackcallback方式返回是否激活成功

    示例

    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]普通设备管理员应用
    callbackAsyncCallbackcallback方式返回是否去激活成功

    示例

    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超级设备管理员应用的包名
    callbackAsyncCallbackcallback方式返回是否去激活成功

    示例

    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]设备管理员应用
    callbackAsyncCallbackcallback方式返回是否处于激活状态

    示例

    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设备管理员应用
    callbackAsyncCallbackcallback方式返回是否处于激活状态

    示例

    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

    参数:

    参数名类型必填说明
    callbackAsyncCallbackcallback方式返回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]设备管理员应用的企业信息
    callbackAsyncCallbackcallback方式返回是否设置企业信息成功

    示例:

    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超级管理员
  • 相关阅读:
    【C语言】队列的实现
    msvcp140.dll丢失怎么办?msvcp140.dll重新安装的解决方法
    介绍 Apache Spark 的基本概念和在大数据分析中的应用。
    你想要的龙年特效来了
    数字化浪潮,中小企业的降本增效之举
    Spring事务传播之嵌套调用
    关于#jenkins集成apifox#的问题,坐等彭于晏回答
    时间序列分析2--时间序列数据的处理和绘制时序图
    node.js——模块化
    linux的sftp复制传输文件
  • 原文地址:https://blog.csdn.net/2301_76813281/article/details/139453184