说明:
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
import enterpriseDeviceManager from '@ohos.enterpriseDeviceManager';
activateAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, callback: AsyncCallback): void
以异步方法根据给定的包名和类名激活设备管理员应用,使用Callback形式返回是否激活成功。
需要权限: ohos.permission.MANAGE_ADMIN
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
admin | [Want] | 是 | 设备管理员应用 |
enterpriseInfo | [EnterpriseInfo] | 是 | 设备管理员应用的企业信息 |
type | [AdminType] | 是 | 激活的设备管理员类型 |
callback | AsyncCallback | 是 | 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);
});
activateAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType): Promise
以异步方法根据给定的包名和类名激活设备管理员应用,使用Promise形式返回是否激活成功。
需要权限: ohos.permission.MANAGE_ADMIN
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
admin | [Want] | 是 | 设备管理员应用 |
enterpriseInfo | [EnterpriseInfo] | 是 | 设备管理员应用的企业信息 |
type | [AdminType] | 是 | 激活的设备管理员类型 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回是否激活成功 |
示例:
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);
});
deactivateAdmin(admin: Want, callback: AsyncCallback): void
以异步方法根据给定的包名和类名将设备普通管理员应用去激活,使用Callback形式返回是否去激活成功。
需要权限: ohos.permission.MANAGE_ADMIN
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
admin | [Want] | 是 | 普通设备管理员应用 |
callback | AsyncCallback | 是 | 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);
});
deactivateAdmin(admin: Want): Promise
以异步方法根据给定的包名和类名将设备普通管理员应用去激活,使用Promise形式返回是否去激活成功。
需要权限: ohos.permission.MANAGE_ADMIN
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
admin | [Want] | 是 | 普通设备管理员应用 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回是否激活成功 |
示例:
let wantTemp = {
bundleName: "bundleName",
abilityName: "abilityName",
};
enterpriseDeviceManager.deactivateAdmin(wantTemp).then((result) => {
console.log("result is " + result);
}).catch(error => {
console.log("error occurs" + error);
});
deactivateSuperAdmin(bundleName: String, callback: AsyncCallback): void
以异步方法根据给定的包名将设备超级管理员应用去激活,使用Callback形式返回是否去激活成功。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
bundleName | String | 是 | 超级设备管理员应用的包名 |
callback | AsyncCallback | 是 | 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);
});
deactivateSuperAdmin(bundleName: String): Promise
以异步方法根据给定的包名将设备超级管理员应用去激活,使用Promise形式返回是否去激活成功。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
bundleName | String | 是 | 超级设备管理员应用的包名 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回是否激活成功 |
示例:
let bundleName = "com.example.myapplication";
enterpriseDeviceManager.deactivateSuperAdmin(bundleName).then((result) => {
console.log("result is " + result);
}).catch(error => {
console.log("error occurs" + error);
});
isAdminAppActive(admin: Want, callback: AsyncCallback): void
以异步方法根据给定的包名和类名判断设备管理员应用是否被激活,使用Callback形式返回是否处于激活状态。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
admin | [Want] | 是 | 设备管理员应用 |
callback | AsyncCallback | 是 | 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);
});
isAdminAppActive(admin: Want): Promise
以异步方法根据给定的包名和类名判断设备管理员应用是否被激活,使用Promise形式返回是否处于激活状态。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
admin | [Want] | 是 | 设备管理员应用 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回是否处于激活状态 |
示例:
let wantTemp = {
bundleName: "bundleName",
abilityName: "abilityName",
};
enterpriseDeviceManager.isAdminAppActive(wantTemp).then((result) => {
console.log("result is " + result);
}).catch(error => {
console.log("error occurs" + error);
});
isSuperAdmin(bundleName: String, callback: AsyncCallback): void
以异步方法根据给定的包名判断设备超级管理员应用是否被激活,使用Callback形式返回是否处于激活状态。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
bundleName | String | 是 | 设备管理员应用 |
callback | AsyncCallback | 是 | 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);
});
isSuperAdmin(bundleName: String): Promise
以异步方法根据给定的包名判断设备超级管理员应用是否被激活,使用Promise形式返回是否处于激活状态。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
bundleName | String | 是 | 超级设备管理员应用 |
返回值:
类型 | 说明 |
---|---|
Promise | Promise形式返回是否处于激活状态 |
示例:
let bundleName = "com.example.myapplication";
enterpriseDeviceManager.isSuperAdmin(bundleName).then((result) => {
console.log("result is " + result);
}).catch(error => {
console.log("error occurs" + error);
});
getDeviceSettingsManager(callback: AsyncCallback): void
获取DeviceSettingsManager对象,使用callback形式返回DeviceSettingsManager对象。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback | 是 | 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);
}
});
});
getDeviceSettingsManager(): Promise
获取DeviceSettingsManager对象,使用Promise形式返回DeviceSettingsManager对象。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
返回值:
类型 | 说明 |
---|---|
Promise | Promise方式返回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);
})
setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo, callback: AsyncCallback): void
设置设备管理员应用的企业信息,使用callback形式返回是否设置成功。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
admin | [Want] | 是 | 设备管理员应用 |
enterpriseInfo | [EnterpriseInfo] | 是 | 设备管理员应用的企业信息 |
callback | AsyncCallback | 是 | 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);
});
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);
});
getEnterpriseInfo(admin: Want, callback: AsyncCallback): void
获取设备管理员应用的企业信息,使用callback形式返回设备管理员应用的企业信息。
系统能力: SystemCapability.Customation.EnterpriseDeviceManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
admin | [Want] | 是 | 设备管理员应用 |
callback | AsyncCallback<[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);
});
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);
});
设备管理员应用的企业信息
系统能力: 以下各项对应系统能力均为SystemCapability.Customation.EnterpriseDeviceManager
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
name | 只读 | string | 是 | 表示设备管理员应用所属企业的名称。 |
description | 只读 | string | 是 | 表示设备管理员应用所属企业的描述。 |
设备管理员应用的管理员类型。
系统能力: 以下各项对应系统能力均为SystemCapability.Customation.EnterpriseDeviceManager
名称 | 默认值 | 说明 |
---|---|---|
ADMIN_TYPE_NORMAL | 0x00 | 普通管理员 |
ADMIN_TYPE_SUPER | 0x01 | 超级管理员 |