1# RunningMultiInstanceInfo (系统接口)
2
3定义多实例应用在运行态的结构信息。
4
5> **说明：**
6>
7> 本模块首批接口从API version 14 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> 本模块接口为系统接口。
9
10## 属性
11
12**系统接口**：此接口为系统接口。
13
14**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
15
16| 名称                      | 类型   | 只读 | 可选  | 说明       |
17| ------------------------- | ------ | ---- | ---- | --------- |
18| instanceKey | string | 是 | 否  | 多实例应用的唯一实例标识。 |
19| uid | number | 是 | 否  | 表示应用程序的UID。 |
20| pids | Array\<number> | 是 | 否  | 应用的进程ID集合。 |
21
22## 使用说明
23
24通过appManager的[getRunningMultiAppInfo](js-apis-app-ability-appManager-sys.md#appmanagergetrunningmultiappinfo12)来获取。
25
26**示例：**
27
28```ts
29import { appManager } from '@kit.AbilityKit';
30import { hilog } from '@kit.PerformanceAnalysisKit';
31import { BusinessError } from '@kit.BasicServicesKit';
32
33try {
34  let bundleName = "ohos.samples.etsclock";
35  appManager.getRunningMultiAppInfo(bundleName).then((info: appManager.RunningMultiAppInfo) => {
36      hilog.info(0x0000, 'testTag', `getRunningMultiAppInfo success`);
37    }).catch((err: BusinessError) => {
38      hilog.error(0x0000, 'testTag', `getRunningMultiAppInfo error, code: ${err.code}, msg:${err.message}`);
39    })
40} catch (err) {
41  hilog.error(0x0000, 'testTag', `getRunningMultiAppInfo error, code: ${err.code}, msg:${err.message}`);
42}
43```
44