@ohos.enterprise.securityManager（安全管理）(系统接口)

本模块提供设备安全管理的能力，包括查询安全补丁状态、查询文件加密状态等。

说明：

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

本模块接口仅可在Stage模型下使用。

本模块接口仅对设备管理应用开放，需将设备管理应用激活后调用，实现相应功能。

本模块接口均为系统接口。

导入模块

import securityManager from '@ohos.enterprise.securityManager';

securityManager.getSecurityPatchTag

getSecurityPatchTag(admin: Want): string

以同步方法查询设备安全补丁Tag。成功返回安全补丁Tag，失败抛出对应异常。

需要权限： ohos.permission.ENTERPRISE_MANAGE_SECURITY

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API： 此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见企业设备管理错误码

示例：

import Want from '@ohos.app.ability.Want';

let wantTemp: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility',
};

try {
    let res: string = securityManager.getSecurityPatchTag(wantTemp);
    console.info(`Succeeded in getting security patch tag. tag: ${res}`);
} catch(err) {
    console.error(`Failed to get security patch tag. Code: ${err.code}, message: ${err.message}`);
}

securityManager.getDeviceEncryptionStatus

getDeviceEncryptionStatus(admin: Want): DeviceEncryptionStatus

以同步方法查询设备文件系统加密状态。成功返回设备文件系统加密状态，失败抛出对应异常。

需要权限： ohos.permission.ENTERPRISE_MANAGE_SECURITY

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API： 此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见企业设备管理错误码

示例：

import Want from '@ohos.app.ability.Want';
let wantTemp: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility',
};

try {
    let result: securityManager.DeviceEncryptionStatus = securityManager.getDeviceEncryptionStatus(wantTemp);
    console.info(`Succeeded in getting device encryption status. isEncrypted: ${result.isEncrypted}`);
} catch(err) {
    console.error(`Failed to get device encryption status. Code: ${err.code}, message: ${err.message}`);
}

DeviceEncryptionStatus

设备管理应用的文件系统加密状态。

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。