通知类客户端信息查询场景
============

从26.0.0开始，支持三方安全应用获取设备上全量的安全审计通知类客户端信息。

#### 场景介绍

应用调用[acquireAllClientsInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-securityaudit-api#acquireallclientsinfo)接口可以获取设备上订阅了安全审计通知类事件的所有客户端信息，用于查看当前已被创建的客户端数量以及每个客户端创建者的进程名、进程ID和用户ID。

#### 约束和限制

1.  当前能力仅支持2in1设备。
    
2.  当前支持查询全量安全审计通知类客户端信息，最多存在16个客户端。
    

#### 业务流程

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8f/v3/9HoZy5uvSneiaZioleLkOQ/zh-cn_image_0000002664208215.png?HW-CC-KV=V1&HW-CC-Date=20260709T132416Z&HW-CC-Expire=86400&HW-CC-Sign=4295EE053E3F8BD184D815D17EBF2589C2B623DE13514C825F53B4720B432E2B)

**流程说明：**

1.  应用调用查询通知类客户端信息接口[acquireAllClientsInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-securityaudit-api#acquireallclientsinfo)获取全量通知类客户端信息。
2.  [acquireAllClientsInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-securityaudit-api#acquireallclientsinfo)接口同步返回通知类客户端信息给应用，应用根据返回的通知类客户端信息进行业务处理。

#### 接口说明

接口如下表，更多接口及使用方法请参见[API参考](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-securityaudit-api#acquireallclientsinfo)。

| 接口名 | 描述 |
| :-- | :-- |
| [acquireAllClientsInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-securityaudit-api#acquireallclientsinfo)(): string | 获取所有的安全审计通知类客户端信息。 |

#### 开发步骤

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ef/v3/eRfbc3UGQbKmuUUuMCrMGg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132416Z&HW-CC-Expire=86400&HW-CC-Sign=FC5845B20514789FA9867BB2DFBA62F6F5E77D687FF44F0EC038EE33D04C02A4)

在开发准备过程中，需要申请权限：ohos.permission.QUERY\_AUDIT\_EVENT。只允许清单内的企业类应用申请该权限，申请方式请参考：[申请使用企业类应用可用权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/permissions-for-enterprise-apps)。

1.  导入Device Security Kit模块及相关公共模块。
    
    import { securityAudit } from '@kit.DeviceSecurityKit';
    import { BusinessError} from '@kit.BasicServicesKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    
2.  开发者调用查询通知类客户端信息接口[acquireAllClientsInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-securityaudit-api#acquireallclientsinfo)，获取所有的通知类客户端信息。
    
    const TAG = "SecurityAuditJsTest";
    try {
      hilog.info(0x0000, TAG, 'acquireAllClientsInfo begin.');
      const result = securityAudit.acquireAllClientsInfo();
      hilog.info(0x0000, TAG, 'Succeeded in acquireAllClientsInfo.');
    } catch (err) {
      let e: BusinessError = err as BusinessError;
      hilog.error(0x0000, TAG, 'acquireAllClientsInfo failed: %{public}d %{public}s', e.code, e.message);
    }