企業(yè)設備管理

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 9開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。

導入模塊

import enterpriseDeviceManager from '@ohos.enterpriseDeviceManager';

enterpriseDeviceManager.activateAdmin

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

以異步方法根據(jù)給定的包名和類名激活設備管理員應用，使用Callback形式返回是否激活成功。

需要權限： ohos.permission.MANAGE_ADMIN

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

示例 ：

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

以異步方法根據(jù)給定的包名和類名激活設備管理員應用，使用Promise形式返回是否激活成功。

需要權限： ohos.permission.MANAGE_ADMIN

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

返回值：

示例 ：

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

以異步方法根據(jù)給定的包名和類名將設備普通管理員應用去激活，使用Callback形式返回是否去激活成功。

需要權限： ohos.permission.MANAGE_ADMIN

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

示例 ：

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

以異步方法根據(jù)給定的包名和類名將設備普通管理員應用去激活，使用Promise形式返回是否去激活成功。

需要權限： ohos.permission.MANAGE_ADMIN

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

返回值：

示例 ：

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

以異步方法根據(jù)給定的包名將設備超級管理員應用去激活，使用Callback形式返回是否去激活成功。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

示例 ：

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

以異步方法根據(jù)給定的包名將設備超級管理員應用去激活，使用Promise形式返回是否去激活成功。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

返回值：

示例 ：

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

以異步方法根據(jù)給定的包名和類名判斷設備管理員應用是否被激活，使用Callback形式返回是否處于激活狀態(tài)。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

示例 ：

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

以異步方法根據(jù)給定的包名和類名判斷設備管理員應用是否被激活，使用Promise形式返回是否處于激活狀態(tài)。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

返回值：

示例 ：

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

以異步方法根據(jù)給定的包名判斷設備超級管理員應用是否被激活，使用Callback形式返回是否處于激活狀態(tài)。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

示例 ：

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

以異步方法根據(jù)給定的包名判斷設備超級管理員應用是否被激活，使用Promise形式返回是否處于激活狀態(tài)。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù) ：

返回值：

示例 ：

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對象。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù)：

示例：

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對象。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

返回值：

示例：

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

設置設備管理員應用的企業(yè)信息，使用callback形式返回是否設置成功。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù)：

示例：

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

設置設備管理員應用的企業(yè)信息，使用Promise形式返回是否設置成功。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù)：

返回值：

示例：

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

獲取設備管理員應用的企業(yè)信息，使用callback形式返回設備管理員應用的企業(yè)信息。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù)：

示例：

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

獲取設備管理員應用的企業(yè)信息，使用Promise形式返回設備管理員應用的企業(yè)信息。

系統(tǒng)能力： SystemCapability.Customation.EnterpriseDeviceManager

參數(shù)：

返回值：

示例：

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

設備管理員應用的企業(yè)信息

系統(tǒng)能力： 以下各項對應系統(tǒng)能力均為SystemCapability.Customation.EnterpriseDeviceManager

AdminType

設備管理員應用的管理員類型。

系統(tǒng)能力： 以下各項對應系統(tǒng)能力均為SystemCapability.Customation.EnterpriseDeviceManager

審核編輯 黃宇