## 概述

PC/2in1

提供安全审计的API。

**系统能力：** SystemCapability.Security.SecurityAudit

**起始版本：** 6.0.0(20)

## 汇总

PC/2in1

### 文件

PC/2in1

展开

| 名称 | 描述 |
| --- | --- |
| [security\_audit.h](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-capi-security-audit-8h) | 文件中定义了与安全审计相关的函数。 |

### 结构体

PC/2in1

展开

| 名称 | 描述 |
| --- | --- |
| struct [SecurityAudit\_Event](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-capi-structs-securityaudit-event) | 定义审计事件信息。 |
| struct [SecurityAudit\_Filter](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-capi-structs-securityaudit-filter) | 提供过滤条件。 |

### 类型定义

PC/2in1

展开

| 名称 | 描述 |
| --- | --- |
| typedef void(\* [SecurityAudit\_Handler](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_handler)) (const [SecurityAudit\_Event](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-capi-structs-securityaudit-event) \*events, uint64\_t count) | 定义事件处理函数。 |
| typedef struct SecurityAudit\_AuthClient\_Impl [SecurityAudit\_AuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authclient) | 定义阻断事件客户端。 |
| typedef struct SecurityAudit\_Client\_Impl [SecurityAudit\_Client](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_client) | 定义通知事件客户端。 |

### 枚举

PC/2in1

展开

| 名称 | 描述 |
| --- | --- |
| [SecurityAudit\_Notify\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_notify_event) {  SECURITY\_AUDIT\_NOTIFY\_EVENT\_PASTEBOARD = 0x27000000, SECURITY\_AUDIT\_NOTIFY\_EVENT\_FILE = 0x1C000007, SECURITY\_AUDIT\_NOTIFY\_EVENT\_FILE\_INTERCEPTED = 0x2700003C, SECURITY\_AUDIT\_NOTIFY\_EVENT\_ACCOUNT = 0x10000100,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_WINDOW = 0x07000000, SECURITY\_AUDIT\_NOTIFY\_EVENT\_VOLUME = 0x0F000000, SECURITY\_AUDIT\_NOTIFY\_EVENT\_PRINTER = 0x2E000000, SECURITY\_AUDIT\_NOTIFY\_EVENT\_PROCESS = 0x1C000008,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_NETWORK\_TRAFFIC = 0x1C00000E, SECURITY\_AUDIT\_NOTIFY\_EVENT\_NETWORK\_CONN = 0x1C00000F, SECURITY\_AUDIT\_NOTIFY\_EVENT\_CAMERA = 0x2D000000, SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP = 0x10000000,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_EDM = 0x11000000, SECURITY\_AUDIT\_NOTIFY\_EVENT\_CERT = 0x12003000, SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_CREATE = 0x1C00000B, SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_READ = 0x1C000012,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_VARIANT = 0x1C00000C, SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_INTERCEPT = 0x1C00000A, SECURITY\_AUDIT\_NOTIFY\_EVENT\_PERMISSION = 0x0B000000, SECURITY\_AUDIT\_NOTIFY\_EVENT\_DNS = 0x03000001,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_INSTALL\_INTERCEPTED = 0x18000100, SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_UNINSTALL\_INTERCEPTED = 0x18000101, SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_UPDATE\_INTERCEPTED = 0x18000102, SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_RECOVER\_INTERCEPTED = 0x18000103,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_START\_INTERCEPTED = 0x18000104, SECURITY\_AUDIT\_NOTIFY\_EVENT\_USB\_ACCESS\_INTERCEPTED = 0x30000000,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_SMB\_FILE\_SEND = 0x0F000001,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_PRE\_OPEN = 0x1C000014,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_HDC\_DEBUG = 0x27000100,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_HDC\_DEBUG\_INTERCEPTED = 0x27000101,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_USER\_SPACE\_DATA\_TRANSFER = 0x2F000000,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_USER\_SPACE\_DATA\_TRANSFER\_POLICY = 0x2F000001,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_SERIAL\_PORT\_ACCESS = 0x30000100,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_NETWORK\_INTERCEPTED = 0x03000002,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_WIFI\_INTERCEPTED = 0x03000100,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_PRINT\_INTERCEPTED = 0x2E000001,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_CS\_VERIFY\_NULL = 0x12001081,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_CS\_VERIFY\_ABNORMAL = 0x12001082,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_FS\_MOUNT\_ABNORMAL = 0x1C001102,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_DRIVER\_CS\_ABNORMAL = 0x1C001200,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_DRIVER\_MMAP\_ABNORMAL = 0x1C001201,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_KERNEL\_MEMORY\_ABNORMAL = 0x1C001300,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_PROCESS\_DEBUG\_ABNORMAL = 0x1C001401,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_PROCESS\_CRASH\_ABNORMAL = 0x1C001402,  SECURITY\_AUDIT\_NOTIFY\_EVENT\_PROCESS\_PRIVILEGE\_ESCALATION = 0x1C001403,  } | 定义通知事件的事件ID。 |
| [SecurityAudit\_Auth\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_auth_event) {  SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_CREATE = 0x1C801100, SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_OPEN = 0x1C801101, SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_RENAME = 0x1C801102, SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_DELETE = 0x1C801103,  SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_SETEXTATTR = 0x1C801104, SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_DELETEEXTATTR = 0x1C801105  } | 定义阻断类事件的事件ID。 |
| [SecurityAudit\_FilterType](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_filtertype) {  EVENT\_TYPE\_EQUAL = 0x00000100, EVENT\_SUBTYPE\_EQUAL = 0x00000200, FILE\_PATH\_EQUAL = 0x00010000, FILE\_PATH\_PREFIX = 0x00010001,  FILE\_PATH\_SUFFIX = 0x00010002, PROCESS\_UID\_EQUAL = 0x00020000, PROCESS\_PID\_EQUAL = 0x00020100, PROCESS\_NAME\_EQUAL = 0x00020200,  PROCESS\_NAME\_PREFIX = 0x00020201, PROCESS\_NAME\_SUFFIX = 0x00020202  } | 定义过滤器类型。 |
| [SecurityAudit\_AuthResult](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authresult) { SECURITY\_AUDIT\_AUTH\_RESULT\_ALLOW = 0, SECURITY\_AUDIT\_AUTH\_RESULT\_DENY = 1 } | 定义阻断结果的类型。 |

### 函数

PC/2in1

展开

| 名称 | 描述 |
| --- | --- |
| int32\_t [HMS\_SecurityAudit\_NewClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_newclient) ([SecurityAudit\_Client](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_client) \*\*client, [SecurityAudit\_Handler](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_handler) handler) | 创建一个新的通知事件客户端。 |
| int32\_t [HMS\_SecurityAudit\_DeleteClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_deleteclient) ([SecurityAudit\_Client](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_client) \*client) | 删除通知客户端。 |
| int32\_t [HMS\_SecurityAudit\_Subscribe](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_subscribe) (const [SecurityAudit\_Client](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_client) \*client, const [SecurityAudit\_Notify\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_notify_event) \*events, uint64\_t count) | 订阅通知事件。 |
| int32\_t [HMS\_SecurityAudit\_Unsubscribe](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_unsubscribe) (const [SecurityAudit\_Client](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_client) \*client, const [SecurityAudit\_Notify\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_notify_event) \*events, uint64\_t count) | 取消订阅通知事件。 |
| int32\_t [HMS\_SecurityAudit\_AddFilter](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_addfilter) (const [SecurityAudit\_Client](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_client) \*client, [SecurityAudit\_Notify\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_notify_event) event, const [SecurityAudit\_Filter](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-capi-structs-securityaudit-filter) \*filter) | 为通知事件添加过滤条件。 |
| int32\_t [HMS\_SecurityAudit\_RemoveFilter](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_removefilter) (const [SecurityAudit\_Client](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_client) \*client, [SecurityAudit\_Notify\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_notify_event) event, const [SecurityAudit\_Filter](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-capi-structs-securityaudit-filter) \*filter) | 删除通知事件的过滤条件。 |
| int32\_t [HMS\_SecurityAudit\_NewAuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_newauthclient) ([SecurityAudit\_AuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authclient) \*\*client, [SecurityAudit\_Handler](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_handler) handler) | 创建一个新的阻断类事件客户端。 |
| int32\_t [HMS\_SecurityAudit\_DeleteAuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_deleteauthclient) ([SecurityAudit\_AuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authclient) \*client) | 删除阻断类事件客户端。 |
| int32\_t [HMS\_SecurityAudit\_SubscribeAuthEvent](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_subscribeauthevent) (const [SecurityAudit\_AuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authclient) \*client, const [SecurityAudit\_Auth\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_auth_event) \*events, uint64\_t count) | 订阅阻断类事件。 |
| int32\_t [HMS\_SecurityAudit\_UnsubscribeAuthEvent](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_unsubscribeauthevent) (const [SecurityAudit\_AuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authclient) \*client, const [SecurityAudit\_Auth\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_auth_event) \*events, uint64\_t count) | 取消订阅阻断类事件。 |
| int32\_t [HMS\_SecurityAudit\_AddAuthEventFilter](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_addautheventfilter) (const [SecurityAudit\_AuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authclient) \*client, [SecurityAudit\_Auth\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_auth_event) event, const [SecurityAudit\_Filter](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-capi-structs-securityaudit-filter) \*filter) | 为阻断类事件添加过滤条件。 |
| int32\_t [HMS\_SecurityAudit\_RemoveAuthEventFilter](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_removeautheventfilter) (const [SecurityAudit\_AuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authclient) \*client, [SecurityAudit\_Auth\_Event](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_auth_event) event, const [SecurityAudit\_Filter](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-capi-structs-securityaudit-filter) \*filter) | 删除阻断类事件的过滤条件。 |
| int32\_t [HMS\_SecurityAudit\_Auth](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_auth) (const [SecurityAudit\_AuthClient](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authclient) \*client, const [SecurityAudit\_Event](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-capi-structs-securityaudit-event) \*event, [SecurityAudit\_AuthResult](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#securityaudit_authresult) authResult) | 设置审计事件的阻断结果。 |
| int32\_t [HMS\_SecurityAudit\_QueryAllProcesses](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_queryallprocesses)(char\*\* result) | 获取所有的应用进程信息。 |
| int32\_t [HMS\_SecurityAudit\_QueryProcesses](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_queryprocesses)(uint64\_t\* pids, uint64\_t count, char\*\* result) | 获取输入的pid的应用进程信息。 |
| int32\_t [HMS\_SecurityAudit\_AcquireCodeSign](/consumer/cn/doc/harmonyos-references/devicesecurity-capi-securityaudit#hms_securityaudit_acquirecodesign)(char\* path, char\*\* outOwnedResult) | 获取输入的文件路径的代码签名信息。 |

## 类型定义说明

PC/2in1

### SecurityAudit\_AuthClient

PC/2in1



```
1. typedef struct SecurityAudit_AuthClient_Impl SecurityAudit_AuthClient
```

**描述**

定义阻断事件客户端。

**起始版本：** 6.0.0(20)

### SecurityAudit\_Client

PC/2in1



```
1. typedef struct SecurityAudit_Client_Impl SecurityAudit_Client
```

**描述**

定义通知事件客户端。

**起始版本：** 6.0.0(20)

### SecurityAudit\_Handler

PC/2in1



```
1. typedef void(* SecurityAudit_Handler) (const SecurityAudit_Event *events, uint64_t count)
```

**描述**

定义事件处理函数。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| events | 指向审计事件信息的指针。 |
| count | 数组中的事件数。 |

## 枚举类型说明

PC/2in1

### SecurityAudit\_Auth\_Event

PC/2in1



```
1. enum SecurityAudit_Auth_Event
```

**描述**

定义阻断事件的事件ID。

**系统能力：** SystemCapability.Security.SecurityAudit

**起始版本：** 6.0.0(20)

展开

| 枚举值 | 描述 |
| --- | --- |
| SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_CREATE | 文件创建阻断事件。 |
| SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_OPEN | 文件打开阻断事件。 |
| SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_RENAME | 文件重命名阻断事件。 |
| SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_DELETE | 文件删除阻断事件。 |
| SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_SETEXTATTR | 文件设置扩展属性的阻断事件。 |
| SECURITY\_AUDIT\_AUTH\_EVENT\_FILE\_DELETEEXTATTR | 文件删除扩展属性的阻断事件。 |

### SecurityAudit\_AuthResult

PC/2in1



```
1. enum SecurityAudit_AuthResult
```

**描述**

定义阻断结果的类型。

**起始版本：** 6.0.0(20)

展开

| 枚举值 | 描述 |
| --- | --- |
| SECURITY\_AUDIT\_AUTH\_RESULT\_ALLOW | 允许的阻断事件。 |
| SECURITY\_AUDIT\_AUTH\_RESULT\_DENY | 拒绝的阻断事件。 |

### SecurityAudit\_FilterType

PC/2in1



```
1. enum SecurityAudit_FilterType
```

**描述**

定义过滤器类型。

**系统能力：** SystemCapability.Security.SecurityAudit

**起始版本：** 6.0.0(20)

展开

| 枚举值 | 描述 |
| --- | --- |
| EVENT\_TYPE\_EQUAL | 事件类型的过滤器类型。 |
| EVENT\_SUBTYPE\_EQUAL | 事件子类型的过滤器类型。 |
| FILE\_PATH\_EQUAL | 文件路径类型的过滤器类型。 |
| FILE\_PATH\_PREFIX | 文件路径前缀类型的过滤器类型。 |
| FILE\_PATH\_SUFFIX | 文件路径后缀类型的过滤器类型。 |
| PROCESS\_UID\_EQUAL | 过滤进程的 UID 类型。 |
| PROCESS\_PID\_EQUAL | 过滤进程 ID 类型。 |
| PROCESS\_NAME\_EQUAL | 筛选进程名称类型。 |
| PROCESS\_NAME\_PREFIX | 进程名称前缀的过滤类型。 |
| PROCESS\_NAME\_SUFFIX | 进程名称后缀的过滤类型。 |

### SecurityAudit\_Notify\_Event

PC/2in1



```
1. enum SecurityAudit_Notify_Event
```

**描述**

定义通知事件的事件ID。

**系统能力：** SystemCapability.Security.SecurityAudit

**起始版本：** 6.0.0(20)

展开

| 枚举值 | 描述 |
| --- | --- |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_PASTEBOARD | 剪贴板复制和粘贴事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_FILE | 文件事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_FILE\_INTERCEPTED | 文件访问规则违规事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_ACCOUNT | 账户登录和注销事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_WINDOW | 窗口截图、屏幕录制、屏幕投影事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_VOLUME | 可移动存储设备的插入和移除事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_PRINTER | 打印机事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_PROCESS | 进程创建退出事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_NETWORK\_TRAFFIC | 网络流量事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_NETWORK\_CONN | 网络连接事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_CAMERA | 相机事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP | 应用程序事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_EDM | 企业设备管理事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_CERT | 证书操作事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_CREATE | KIA文件创建事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_READ | KIA文件读取事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_VARIANT | KIA文件变体事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_INTERCEPT | KIA文件拦截事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_PERMISSION | 应用程序权限更改事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_DNS | DNS审计事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_INSTALL\_INTERCEPTED | 应用程序安装拦截事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_UNINSTALL\_INTERCEPTED | 应用程序卸载拦截事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_UPDATE\_INTERCEPTED | 应用程序更新拦截事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_RECOVER\_INTERCEPTED | 应用程序恢复拦截事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_APP\_START\_INTERCEPTED | 应用程序开始拦截事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_USB\_ACCESS\_INTERCEPTED | USB访问拦截事件。 |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_SMB\_FILE\_SEND | SMB(Samba)外发事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_KIA\_PRE\_OPEN | KIA文件秒开事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_HDC\_DEBUG | HDC(HarmonyOS Device Connector)调测文件事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_HDC\_DEBUG\_INTERCEPTED | HDC(HarmonyOS Device Connector)调测拦截事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_USER\_SPACE\_DATA\_TRANSFER | 多用户空间数据互传事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_USER\_SPACE\_DATA\_TRANSFER\_POLICY | 多用户空间互换审核策略事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_SERIAL\_PORT\_ACCESS | 串口访问审计事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_NETWORK\_INTERCEPTED | 网络拦截事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_WIFI\_INTERCEPTED | WI-FI拦截事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_PRINT\_INTERCEPTED | 打印拦截事件  起始版本：6.1.0(23) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_PROCESS\_PRIVILEGE\_ESCALATION | 进程提权事件  起始版本：6.1.1(24) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_PROCESS\_DEBUG\_ABNORMAL | 进程异常调试事件  起始版本：6.1.1(24) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_FS\_MOUNT\_ABNORMAL | 系统目录异常挂载事件  起始版本：6.1.1(24) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_PROCESS\_CRASH\_ABNORMAL | 进程异常崩溃事件  起始版本：6.1.1(24) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_CS\_VERIFY\_NULL | 应用代码未签名事件  起始版本：6.1.1(24) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_CS\_VERIFY\_ABNORMAL | 应用代码验签异常事件  起始版本：6.1.1(24) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_DRIVER\_CS\_ABNORMAL | 驱动代码验签异常事件  起始版本：6.1.1(24) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_DRIVER\_MMAP\_ABNORMAL | 驱动非法映射内核内存事件  起始版本：6.1.1(24) |
| SECURITY\_AUDIT\_NOTIFY\_EVENT\_KERNEL\_MEMORY\_ABNORMAL | 内核内存异常使用事件  起始版本：6.1.1(24) |

## 函数说明

PC/2in1

### HMS\_SecurityAudit\_AddAuthEventFilter()

PC/2in1



```
1. int32_t HMS_SecurityAudit_AddAuthEventFilter (const SecurityAudit_AuthClient * client, SecurityAudit_Auth_Event event, const SecurityAudit_Filter * filter )
```

**描述**

为阻断类事件添加过滤条件。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 用户已创建的阻断类事件客户端。 |
| event | 需要添加过滤条件的阻断类事件。 |
| filter | 阻断类事件的过滤器描述。 |

**Permission：**

ohos.permission.kernel.AUTH\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。 如果过滤器数量超过上限，则返回1012000004。 如果事件不支持过滤条件，则返回1012000005。

### HMS\_SecurityAudit\_AddFilter()

PC/2in1



```
1. int32_t HMS_SecurityAudit_AddFilter (const SecurityAudit_Client * client, SecurityAudit_Notify_Event event, const SecurityAudit_Filter * filter )
```

**描述**

为通知事件添加过滤条件。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 用户已创建的通知类事件客户端。 |
| event | 通知要添加过滤条件的事件。 |
| filter | 通知事件的过滤器描述。 |

**Permission：**

ohos.permission.QUERY\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。 如果过滤器数量超过上限，则返回1012000004。 如果事件不支持过滤条件，则返回1012000005。

### HMS\_SecurityAudit\_Auth()

PC/2in1



```
1. int32_t HMS_SecurityAudit_Auth (const SecurityAudit_AuthClient * client, const SecurityAudit_Event * event, SecurityAudit_AuthResult authResult )
```

**描述**

设置审计事件的阻断结果

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 用户已创建的阻断类事件客户端。 |
| event | 审计阻断类事件信息。 |
| authResult | 阻断结果。 |

**Permission：**

ohos.permission.kernel.AUTH\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。

### HMS\_SecurityAudit\_DeleteAuthClient()

PC/2in1



```
1. int32_t HMS_SecurityAudit_DeleteAuthClient (SecurityAudit_AuthClient * client)
```

**描述**

删除阻断类事件客户端。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 要删除的阻断类事件客户端实例。 |

**Permission：**

ohos.permission.kernel.AUTH\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。

### HMS\_SecurityAudit\_DeleteClient()

PC/2in1



```
1. int32_t HMS_SecurityAudit_DeleteClient (SecurityAudit_Client * client)
```

**描述**

删除通知客户端。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 要删除的客户端实例。 |

**Permission：**

ohos.permission.QUERY\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。

### HMS\_SecurityAudit\_NewAuthClient()

PC/2in1



```
1. int32_t HMS_SecurityAudit_NewAuthClient (SecurityAudit_AuthClient ** client, SecurityAudit_Handler handler )
```

**描述**

创建一个新的阻断类客户端。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 指向新阻断类事件客户端实例的指针。 |
| handler | 处理发送到此客户端的所有消息的处理器。 |

**Permission：**

ohos.permission.kernel.AUTH\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。 如果客户端数量超过总上限，返回1012000002。 如果客户端数量超过当前进程的上限，则返回1012000003。

### HMS\_SecurityAudit\_NewClient()

PC/2in1



```
1. int32_t HMS_SecurityAudit_NewClient (SecurityAudit_Client ** client, SecurityAudit_Handler handler )
```

**描述**

创建一个新的通知事件客户端。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 指向新客户端实例的指针。 |
| handler | 处理发送到此客户端的所有消息的处理器。 |

**Permission：**

ohos.permission.QUERY\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。 如果客户端数量超过总上限，返回1012000002。 如果客户端数量超过当前进程的上限，则返回1012000003。

### HMS\_SecurityAudit\_RemoveAuthEventFilter()

PC/2in1



```
1. int32_t HMS_SecurityAudit_RemoveAuthEventFilter (const SecurityAudit_AuthClient * client, SecurityAudit_Auth_Event event, const SecurityAudit_Filter * filter )
```

**描述**

删除阻断类事件的过滤条件。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 客户已创建的阻断类事件客户端。 |
| event | 要删除过滤条件的阻断类事件。 |
| filter | 阻断类事件的过滤器描述。 |

**Permission：**

ohos.permission.kernel.AUTH\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。 如果事件不支持过滤条件，则返回1012000005。

### HMS\_SecurityAudit\_RemoveFilter()

PC/2in1



```
1. int32_t HMS_SecurityAudit_RemoveFilter (const SecurityAudit_Client * client, SecurityAudit_Notify_Event event, const SecurityAudit_Filter * filter )
```

**描述**

删除通知事件的过滤条件。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 客户已创建的通知类事件客户端。 |
| event | 通知要删除过滤条件的事件。 |
| filter | 通知事件的过滤器描述。 |

**Permission：**

ohos.permission.QUERY\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。 如果事件不支持过滤条件，则返回1012000005。

### HMS\_SecurityAudit\_Subscribe()

PC/2in1



```
1. int32_t HMS_SecurityAudit_Subscribe (const SecurityAudit_Client * client, const SecurityAudit_Notify_Event * events, uint64_t count )
```

**描述**

订阅通知事件。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 订阅通知事件的客户端。 |
| events | 要订阅的通知事件数组。 |
| count | 数组中的通知事件数。 |

**Permission：**

ohos.permission.QUERY\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。

### HMS\_SecurityAudit\_SubscribeAuthEvent()

PC/2in1



```
1. int32_t HMS_SecurityAudit_SubscribeAuthEvent (const SecurityAudit_AuthClient * client, const SecurityAudit_Auth_Event * events, uint64_t count )
```

**描述**

订阅阻断类事件。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 客户已创建的阻断类事件客户端。 |
| events | 要订阅的阻断类事件数组。 |
| count | 数组中的阻断类事件数。 |

**Permission：**

ohos.permission.kernel.AUTH\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。

### HMS\_SecurityAudit\_Unsubscribe()

PC/2in1



```
1. int32_t HMS_SecurityAudit_Unsubscribe (const SecurityAudit_Client * client, const SecurityAudit_Notify_Event * events, uint64_t count )
```

**描述**

取消订阅通知事件。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 取消订阅通知事件的客户端。 |
| events | 要取消订阅的通知事件数组。 |
| count | 数组中的通知事件数。 |

**Permission：**

ohos.permission.QUERY\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。

### HMS\_SecurityAudit\_UnsubscribeAuthEvent()

PC/2in1



```
1. int32_t HMS_SecurityAudit_UnsubscribeAuthEvent (const SecurityAudit_AuthClient * client, const SecurityAudit_Auth_Event * events, uint64_t count )
```

**描述**

取消订阅阻断类事件。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| client | 客户已创建的阻断类事件客户端。 |
| events | 要取消订阅的阻断类事件数组。 |
| count | 数组中的阻断类事件数。 |

**Permission：**

ohos.permission.kernel.AUTH\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001

### HMS\_SecurityAudit\_QueryAllProcesses()

PC/2in1



```
1. int32_t HMS_SecurityAudit_QueryAllProcesses(char** result)
```

**描述**

查询获取所有的应用进程信息。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| result | 查询获取到的应用进程信息。 |

**Permission：**

ohos.permission.QUERY\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。

### HMS\_SecurityAudit\_QueryProcesses()

PC/2in1



```
1. int32_t HMS_SecurityAudit_QueryProcesses(uint64_t* pids, uint64_t count, char** result)
```

**描述**

查询获取输入的pid的应用进程信息。

**起始版本：** 6.0.0(20)

**参数：**

展开

| 名称 | 描述 |
| --- | --- |
| pids | 应用要查询的pid数组名。 |
| count | 应用要查询的pid数组元素个数。 |
| result | 查询获取到的应用进程信息。 |

**Permission：**

ohos.permission.QUERY\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，则返回1012000001。如果要查询的pid数组元素个数超过限制，则返回1012000006。

### HMS\_SecurityAudit\_AcquireCodeSign()

PC/2in1



```
1. int32_t HMS_SecurityAudit_AcquireCodeSign(char* path, char** outOwnedResult)
```

**描述**

获取输入的文件路径的代码签名信息。

**模型约束：** 此接口仅可在Stage模型下使用。

**起始版本：** 6.1.1(24)

**参数:**

展开

| 名称 | 描述 |
| --- | --- |
| path | 待查询的应用文件路径。 |
| outOwnedResult | 代码签名内容，内容为json格式字符串。例如：{"1": {}}。 |

**Permission：**

ohos.permission.QUERY\_AUDIT\_EVENT

**返回：**

函数执行结果。 返回值说明： 如果操作成功，则返回0。 如果权限验证失败，则返回201。 如果发生内部错误，1012000001。如果文件未找到或者应用无打开文件权限，1012000008。