• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1#    系统帐号管理
2
3本模块提供管理系统帐号的一些基础能力,包括系统帐号的添加、删除、查询、设置、订阅、启动等功能,提供系统帐号数据落盘的能力。
4
5> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
6> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
7
8
9## 导入模块
10
11```js
12import account_osAccount from '@ohos.account.osAccount';
13```
14
15## account_osAccount.getAccountManager
16
17getAccountManager(): AccountManager
18
19获取系统帐号能力的实例。
20
21**系统能力:** SystemCapability.Account.OsAccount
22
23**返回值:**
24| 类型                              | 说明                     |
25| --------------------------------- | ------------------------ |
26| [AccountManager](#accountmanager) | 获取系统帐号能力的实例。 |
27
28**示例:**
29  ```js
30  const accountManager = account_osAccount.getAccountManager();
31  ```
32
33## OsAccountType
34
35枚举,系统帐号类型。
36
37**系统能力:** 以下各项对应的系统能力均为SystemCapability.Account.OsAccount38
39| 参数   | 默认值 | 说明         |
40| ------ | ------ | ------------ |
41| ADMIN  | 0      | 管理员帐号。 |
42| NORMAL | 1      | 普通帐号。   |
43| GUEST  | 2      | 访客帐号。   |
44
45## AccountManager
46
47管理系统帐号能力的类。
48
49### activateOsAccount
50
51activateOsAccount(localId: number, callback: AsyncCallback<void>): void
52
53激活指定系统帐号,使用callback回调异步返回结果。
54
55此接口为系统接口,三方应用不支持调用。
56
57**需要权限:** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION
58
59**系统能力:** SystemCapability.Account.OsAccount
60
61**参数:**
62
63| 参数名   | 类型                      | 必填 | 说明                 |
64| -------- | ------------------------- | ---- | -------------------- |
65| localId  | number                    | 是   | 要激活的系统帐号ID。 |
66| callback | AsyncCallback<void> | 是   | 回调结果。           |
67
68**示例:**激活ID为100的系统帐号
69  ```js
70  const accountManager = account_osAccount.getAccountManager();
71  var localId = 100;
72  accountManager.activateOsAccount(localId, (err)=>{
73    console.log("activateOsAccount err:" + JSON.stringify(err));
74  });
75  ```
76
77### activateOsAccount
78
79activateOsAccount(localId: number): Promise<void>
80
81激活指定系统帐号,使用Promise方式异步返回结果。
82
83此接口为系统接口,三方应用不支持调用。
84
85**需要权限:** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION
86
87**系统能力:** SystemCapability.Account.OsAccount
88
89**参数:**
90
91| 参数名  | 类型   | 必填 | 说明                 |
92| ------- | ------ | ---- | -------------------- |
93| localId | number | 是   | 要激活的系统帐号ID。 |
94
95**返回值:**
96
97| 类型                | 说明                                |
98| :------------------ | :---------------------------------- |
99| Promise<void> | Promise实例,用于获取异步返回结果。 |
100
101**示例:**激活ID为100的系统帐号
102  ```js
103  const accountManager = account_osAccount.getAccountManager();
104  var localId = 100;
105  accountManager.activateOsAccount(localId).then(() => {
106    console.log("activateOsAccount success");
107  }).catch((err) => {
108    console.log("activateOsAccount err:" + JSON.stringify(err));
109  });
110  ```
111
112### isMultiOsAccountEnable
113
114isMultiOsAccountEnable(callback: AsyncCallback<boolean>): void
115
116判断是否支持多系统帐号,使用callback回调异步返回结果。
117
118**系统能力:** SystemCapability.Account.OsAccount
119
120**参数:**
121
122| 参数名   | 类型                         | 必填 | 说明                                                |
123| -------- | ---------------------------- | ---- | --------------------------------------------------- |
124| callback | AsyncCallback<boolean> | 是   | 回调结果,支持多系统帐号则返回true,否则返回false。 |
125
126**示例:**
127
128  ```js
129  const accountManager = account_osAccount.getAccountManager();
130  accountManager.isMultiOsAccountEnable((err, isEnabled) => {
131    console.log("isMultiOsAccountEnable err: " + JSON.stringify(err));
132    console.log('isMultiOsAccountEnable isEnabled: ' + isEnabled);
133  });
134  ```
135
136### isMultiOsAccountEnable
137
138isMultiOsAccountEnable(): Promise<boolean>
139
140判断是否支持多系统帐号,使用Promise方式异步返回结果。
141
142**系统能力:** SystemCapability.Account.OsAccount
143
144**返回值:**
145
146| 类型                   | 说明                                                         |
147| :--------------------- | :----------------------------------------------------------- |
148| Promise<boolean> | Promise实例,用于获取异步返回结果,支持多系统帐号则返回true,否则返回false。 |
149
150**示例:**
151
152  ```js
153  const accountManager = account_osAccount.getAccountManager();
154  accountManager.isMultiOsAccountEnable().then((isEnabled) => {
155    console.log('isMultiOsAccountEnable, isEnabled: ' + isEnabled);
156  }).catch((err) => {
157    console.log("isMultiOsAccountEnable err: "  + JSON.stringify(err));
158  });
159  ```
160
161### isOsAccountActived
162
163isOsAccountActived(localId: number, callback: AsyncCallback<boolean>): void
164
165判断指定系统帐号是否处于激活状态,使用callback回调异步返回结果。
166
167**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTSohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
168
169**系统能力:** SystemCapability.Account.OsAccount
170
171**参数:**
172
173| 参数名   | 类型                         | 必填 | 说明                                              |
174| -------- | ---------------------------- | ---- | ------------------------------------------------- |
175| localId  | number                       | 是   | 系统帐号ID。                                      |
176| callback | AsyncCallback<boolean> | 是   | 回调结果,处于激活状态则返回true,否则返回false。 |
177
178**示例:**判断ID为100的系统帐号是否处于激活状态
179
180  ```js
181  const accountManager = account_osAccount.getAccountManager();
182  var osLocalId = 100;
183  accountManager.isOsAccountActived(osLocalId, (err, isActive)=>{
184    console.log("isOsAccountActived err:" + JSON.stringify(err));
185    console.log("isOsAccountActived isActive:" + isActive);
186  });
187  ```
188
189### isOsAccountActived
190
191isOsAccountActived(localId: number): Promise<boolean>
192
193判断指定系统帐号是否处于激活状态,使用Promise方式异步返回结果。
194
195**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTSohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
196
197**系统能力:** SystemCapability.Account.OsAccount
198
199**参数:**
200
201| 参数名  | 类型   | 必填 | 说明         |
202| ------- | ------ | ---- | ------------ |
203| localId | number | 是   | 系统帐号ID。 |
204
205**返回值:**
206
207| 类型                   | 说明                                                         |
208| :--------------------- | :----------------------------------------------------------- |
209| Promise<boolean> | Promise实例,用于获取异步返回结果,处于激活状态则返回true,否则返回false。 |
210
211**示例:**判断ID为100的系统帐号是否处于激活状态
212
213  ```js
214  const accountManager = account_osAccount.getAccountManager();
215  var osLocalId = 100;
216  accountManager.isOsAccountActived(osLocalId).then((isActive) => {
217    console.log('isOsAccountActived, isActive: ' + isActive);
218  }).catch((err) => {
219    console.log("isOsAccountActived err: "  + JSON.stringify(err));
220  });
221  ```
222
223### isOsAccountConstraintEnable
224
225isOsAccountConstraintEnable(localId: number, constraint: string, callback: AsyncCallback<boolean>): void
226
227判断指定系统帐号是否具有指定约束,使用callback回调异步返回结果。
228
229**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
230
231**系统能力:** SystemCapability.Account.OsAccount
232
233**参数:**
234
235| 参数名     | 类型                         | 必填 | 说明                                              |
236| ---------- | ---------------------------- | ---- | ------------------------------------------------- |
237| localId    | number                       | 是   | 指定的系统帐号ID。                                |
238| constraint | string                       | 是   | 指定的[约束](#系统帐号约束列表)名称。             |
239| callback   | AsyncCallback<boolean> | 是   | 回调结果,具有指定约束则返回true,否则返回false。 |
240
241**示例:**判断ID为100的系统帐号是否有禁止使用wifi的约束
242
243  ```js
244  const accountManager = account_osAccount.getAccountManager();
245  var localId = 100;
246  accountManager.isOsAccountConstraintEnable(localId, "constraint.wifi", (err, isConstraintEnabled)=>{
247    console.log("isOsAccountConstraintEnable err:" + JSON.stringify(err));
248    console.log("isOsAccountConstraintEnable isConstraintEnabled:" + isConstraintEnabled);
249  });
250  ```
251
252### isOsAccountConstraintEnable
253
254isOsAccountConstraintEnable(localId: number, constraint: string): Promise<boolean>
255
256判断指定系统帐号是否具有指定约束,使用Promise方式异步返回结果。
257
258**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
259
260**系统能力:** SystemCapability.Account.OsAccount
261
262**参数:**
263
264| 参数名     | 类型   | 必填 | 说明                                  |
265| ---------- | ------ | ---- | ------------------------------------- |
266| localId    | number | 是   | 指定的系统帐号ID。                    |
267| constraint | string | 是   | 指定的[约束](#系统帐号约束列表)名称。 |
268
269**返回值:**
270
271| 类型                   | 说明                                                         |
272| :--------------------- | :----------------------------------------------------------- |
273| Promise<boolean> | Promise实例,用于获取异步返回结果,具有指定约束则返回true,否则返回false。 |
274
275**示例:**判断ID为100的系统帐号是否有禁止使用wifi的约束
276
277  ```js
278  const accountManager = account_osAccount.getAccountManager();
279  var localId = 100;
280  accountManager.isOsAccountConstraintEnable(localId, "constraint.wifi").then((isConstraintEnabled) => {
281    console.log('isOsAccountConstraintEnable, isConstraintEnabled: ' + isConstraintEnabled);
282  }).catch((err) => {
283    console.log("isOsAccountConstraintEnable err: "  + JSON.stringify(err));
284  });
285  ```
286
287### isTestOsAccount
288
289isTestOsAccount(callback: AsyncCallback<boolean>): void
290
291检查当前系统帐号是否为测试帐号,使用callback回调异步返回结果。
292
293**系统能力:** SystemCapability.Account.OsAccount
294
295**参数:**
296
297| 参数名   | 类型                         | 必填 | 说明                                            |
298| -------- | ---------------------------- | ---- | ----------------------------------------------- |
299| callback | AsyncCallback<boolean> | 是   | 回调结果,是测试帐号则返回true,否则返回false。 |
300
301**示例:**
302
303  ```js
304  const accountManager = account_osAccount.getAccountManager();
305  accountManager.isTestOsAccount((err, isTest) => {
306    console.log("isTestOsAccount err: " + JSON.stringify(err));
307    console.log('isTestOsAccount isTest: ' + isTest);
308  });
309  ```
310
311### isTestOsAccount
312
313isTestOsAccount(): Promise<boolean>
314
315检查当前系统帐号是否为测试帐号,使用Promise方式异步返回结果。
316
317**系统能力:** SystemCapability.Account.OsAccount
318
319**返回值:**
320
321| 类型                   | 说明                                                         |
322| :--------------------- | :----------------------------------------------------------- |
323| Promise<boolean> | Promise实例,用于获取异步返回结果,是测试帐号则返回true,否则返回false。 |
324
325**示例:**
326
327  ```js
328  const accountManager = account_osAccount.getAccountManager();
329  accountManager.isTestOsAccount().then((isTest) => {
330    console.log('isTestOsAccount, isTest: ' + isTest);
331  }).catch((err) => {
332    console.log("isTestOsAccount err: "  + JSON.stringify(err));
333  });
334  ```
335
336### isOsAccountVerified
337
338isOsAccountVerified(callback: AsyncCallback<boolean>): void
339
340检查当前系统帐号是否已验证,使用callback回调异步返回结果。
341
342**系统能力:** SystemCapability.Account.OsAccount
343
344**参数:**
345
346| 参数名   | 类型                         | 必填 | 说明                                        |
347| -------- | ---------------------------- | ---- | ------------------------------------------- |
348| callback | AsyncCallback<boolean> | 是   | 回调结果,已验证则返回true,否则返回false。 |
349
350**示例:**
351
352  ```js
353  const accountManager = account_osAccount.getAccountManager();
354  accountManager.isOsAccountVerified((err, isVerified) => {
355    console.log("isOsAccountVerified err: " + JSON.stringify(err));
356    console.log('isOsAccountVerified isVerified: ' + isVerified);
357  });
358  ```
359
360### isOsAccountVerified
361
362isOsAccountVerified(localId: number, callback: AsyncCallback<boolean>): void
363
364检查指定系统帐号是否已验证,使用callback回调异步返回结果。
365
366**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTSohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
367
368**系统能力:** SystemCapability.Account.OsAccount
369
370**参数:**
371
372| 参数名   | 类型                         | 必填 | 说明                                        |
373| -------- | ---------------------------- | ---- | ------------------------------------------- |
374| localId  | number                       | 否   | 指定的系统帐号ID。                          |
375| callback | AsyncCallback<boolean> | 是   | 回调结果,已验证则返回true,否则返回false。 |
376
377**示例:**
378
379  ```js
380  const accountManager = account_osAccount.getAccountManager();
381  accountManager.isOsAccountVerified((err, isVerified) => {
382    console.log("isOsAccountVerified err: " + JSON.stringify(err));
383    console.log('isOsAccountVerified isVerified: ' + isVerified);
384  });
385  ```
386
387### isOsAccountVerified
388
389isOsAccountVerified(localId?: number): Promise<boolean>
390
391检查指定系统帐号是否已验证,使用Promise方式异步返回结果。
392
393**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTSohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
394
395**系统能力:** SystemCapability.Account.OsAccount
396
397**参数:**
398
399| 参数名  | 类型   | 必填 | 说明               |
400| ------- | ------ | ---- | ------------------ |
401| localId | number | 否   | 指定的系统帐号ID。 |
402
403**返回值:**
404
405| 类型                   | 说明                                                         |
406| :--------------------- | :----------------------------------------------------------- |
407| Promise<boolean> | Promise实例,用于获取异步返回结果,已验证则返回true,否则返回false。 |
408
409**示例:**
410
411  ```js
412  const accountManager = account_osAccount.getAccountManager();
413  accountManager.isOsAccountVerified().then((isVerified) => {
414    console.log('isOsAccountVerified, isVerified: ' + isVerified);
415  }).catch((err) => {
416    console.log("isOsAccountVerified err: "  + JSON.stringify(err));
417  });
418  ```
419
420### removeOsAccount
421
422removeOsAccount(localId: number, callback: AsyncCallback<void>): void
423
424删除指定系统帐号,使用callback回调异步返回结果。
425
426此接口为系统接口,三方应用不支持调用。
427
428**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
429
430**系统能力:** SystemCapability.Account.OsAccount
431
432**参数:**
433
434| 参数名   | 类型                      | 必填 | 说明                 |
435| -------- | ------------------------- | ---- | -------------------- |
436| localId  | number                    | 是   | 要删除的系统帐号ID。 |
437| callback | AsyncCallback<void> | 是   | 回调结果。           |
438
439**示例:**
440
441  ```js
442  const accountManager = account_osAccount.getAccountManager();
443  var createIocalId;
444  osAccountManager.createOsAccount("testAccountName", osaccount.OsAccountType.NORMAL, (err, osAccountInfo)=>{
445    createIocalId = osAccountInfo.localId;
446  });
447  accountManager.removeOsAccount(createIocalId, (err)=>{
448    console.log("removeOsAccount err:" + JSON.stringify(err));
449  });
450  ```
451
452### removeOsAccount
453
454removeOsAccount(localId: number): Promise<void>
455
456删除指定系统帐号,使用Promise方式异步返回结果。
457
458此接口为系统接口,三方应用不支持调用。
459
460**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
461
462**系统能力:** SystemCapability.Account.OsAccount
463
464**参数:**
465
466| 参数名  | 类型   | 必填 | 说明                 |
467| ------- | ------ | ---- | -------------------- |
468| localId | number | 是   | 要删除的系统帐号ID。 |
469
470**返回值:**
471
472| 类型                | 说明                                |
473| :------------------ | :---------------------------------- |
474| Promise<void> | Promise实例,用于获取异步返回结果。 |
475
476**示例:**
477
478  ```js
479  const accountManager = account_osAccount.getAccountManager();
480  var createIocalId;
481  osAccountManager.createOsAccount("testAccountName", osaccount.OsAccountType.NORMAL, (err, osAccountInfo)=>{
482    createIocalId = osAccountInfo.localId;
483  });
484  createIocalId = osAccount.localId;
485  accountManager.removeOsAccount(createIocalId).then(() => {
486    console.log('removeOsAccount Success');
487  }).catch(() => {
488    console.log("removeOsAccount err: "  + JSON.stringify(err));
489  });
490  ```
491
492### setOsAccountConstraints
493
494setOsAccountConstraints(localId: number, constraints: Array<string>, enable: boolean,callback: AsyncCallback<void>): void
495
496为指定系统帐号设置/删除约束,使用callback回调异步返回结果。
497
498此接口为系统接口,三方应用不支持调用。
499
500**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
501
502**系统能力:** SystemCapability.Account.OsAccount
503
504**参数:**
505
506| 参数名      | 类型                      | 必填 | 说明                                         |
507| ----------- | ------------------------- | ---- | -------------------------------------------- |
508| localId     | number                    | 是   | 系统帐号ID。                                 |
509| constraints | Array<string>       | 是   | 待设置/删除的[约束](#系统帐号约束列表)列表。 |
510| enable      | boolean                   | 是   | 设置(true)/删除(false)                       |
511| callback    | AsyncCallback<void> | 是   | 回调结果。                                   |
512
513**示例:**给ID为100的系统帐号设置禁止使用wifi的约束
514
515  ```js
516  const accountManager = account_osAccount.getAccountManager();
517  var localId = 100;
518  accountManager.setOsAccountConstraints(localId, ["constraint.wifi"], true, (err)=>{
519    console.log("setOsAccountConstraints err:" + JSON.stringify(err));
520  });
521  ```
522
523### setOsAccountConstraints
524
525setOsAccountConstraints(localId: number, constraints: Array<string>, enable: boolean): Promise<void>
526
527为指定系统帐号设置/删除约束,使用Promise方式异步返回结果。
528
529此接口为系统接口,三方应用不支持调用。
530
531**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
532
533**系统能力:** SystemCapability.Account.OsAccount
534
535**参数:**
536
537| 参数名      | 类型                | 必填 | 说明                                         |
538| ----------- | ------------------- | ---- | -------------------------------------------- |
539| localId     | number              | 是   | 系统帐号ID。                                 |
540| constraints | Array<string> | 是   | 待设置/删除的[约束](#系统帐号约束列表)列表。 |
541| enable      | boolean             | 是   | 设置(true)/删除(false)。                     |
542
543**返回值:**
544
545| 类型                | 说明                                |
546| :------------------ | :---------------------------------- |
547| Promise<void> | Promise实例,用于获取异步返回结果。 |
548
549**示例:**删除ID为100的系统帐号的禁止使用wifi的约束
550
551  ```js
552  const accountManager = account_osAccount.getAccountManager();
553  var localId = 100;
554  accountManager.setOsAccountConstraints(localId, ["constraint.location.set"], false).then(() => {
555    console.log('setOsAccountConstraints Success');
556  }).catch((err) => {
557    console.log("setOsAccountConstraints err: "  + JSON.stringify(err));
558  });
559  ```
560
561### setOsAccountName
562
563setOsAccountName(localId: number, localName: string, callback: AsyncCallback<void>): void
564
565设置指定系统帐号的帐号名,使用callback回调异步返回结果。
566
567此接口为系统接口,三方应用不支持调用。
568
569**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
570
571**系统能力:** SystemCapability.Account.OsAccount
572
573**参数:**
574
575| 参数名    | 类型                      | 必填 | 说明         |
576| :-------- | ------------------------- | ---- | ------------ |
577| localId   | number                    | 是   | 系统帐号ID。 |
578| localName | string                    | 是   | 帐号名。     |
579| callback  | AsyncCallback<void> | 是   | 回调结果。   |
580
581**示例:**将ID为100的系统帐号的帐号名设置成demoName
582
583  ```js
584  const accountManager = account_osAccount.getAccountManager();
585  var localId = 100;
586  var newName = "demoName";
587  accountManager.setOsAccountName(localId, newName, (err)=>{
588    console.debug("setOsAccountName err:" + JSON.stringify(err));
589  });
590  ```
591
592### setOsAccountName
593
594setOsAccountName(localId: number, localName: string): Promise<void>
595
596设置指定系统帐号的帐号名,使用Promise方式异步返回结果。
597
598此接口为系统接口,三方应用不支持调用。
599
600**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
601
602**系统能力:** SystemCapability.Account.OsAccount
603
604**参数:**
605
606| 参数名    | 类型   | 必填 | 说明         |
607| --------- | ------ | ---- | ------------ |
608| localId   | number | 是   | 系统帐号ID。 |
609| localName | string | 是   | 帐号名。     |
610
611**返回值:**
612
613| 类型                | 说明                                |
614| :------------------ | :---------------------------------- |
615| Promise<void> | Promise实例,用于获取异步返回结果。 |
616
617**示例:**将ID为100的系统帐号的帐号名设置成demoName
618
619  ```js
620  const accountManager = account_osAccount.getAccountManager();
621  var localId = 100;
622  var nameLimit = "demoName";
623  accountManager.setOsAccountName(localId, nameLimit).then(() => {
624    console.log('setOsAccountName Success');
625  }).catch((err) => {
626    console.log("setOsAccountName err: "  + JSON.stringify(err));
627  });
628  ```
629
630### getCreatedOsAccountsCount
631
632getCreatedOsAccountsCount(callback: AsyncCallback<number>): void
633
634获取已创建的系统帐号数量,使用callback回调异步返回结果。
635
636**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
637
638**系统能力:** SystemCapability.Account.OsAccount
639
640**参数:**
641
642| 参数名   | 类型                        | 必填 | 说明                                       |
643| -------- | --------------------------- | ---- | ------------------------------------------ |
644| callback | AsyncCallback<number> | 是   | 回调结果,返回的是已创建的系统帐号的数量。 |
645
646**示例:**
647
648  ```js
649  const accountManager = account_osAccount.getAccountManager();
650  accountManager.getCreatedOsAccountsCount((err, accountCnt)=>{
651    console.log("obtains the number of all os accounts created err:" + JSON.stringify(err));
652    console.log("obtains the number of all os accounts created accountCnt:" + accountCnt);
653  });
654  ```
655
656### getCreatedOsAccountsCount
657
658getCreatedOsAccountsCount(): Promise<number>
659
660获取已创建的系统帐号数量,使用Promise方式异步返回结果。
661
662**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
663
664**系统能力:** SystemCapability.Account.OsAccount
665
666**返回值:**
667
668| 类型                  | 说明                                                         |
669| :-------------------- | :----------------------------------------------------------- |
670| Promise<number> | Promise实例,用于获取异步返回结果,返回的是已创建的系统帐号的数量。 |
671
672**示例:**
673
674  ```js
675  const accountManager = account_osAccount.getAccountManager();
676  accountManager.getCreatedOsAccountsCount().then((accountCnt) => {
677    console.log('getCreatedOsAccountsCount, accountCnt: ' + accountCnt);
678  }).catch((err) => {
679    console.log("getCreatedOsAccountsCount err: "  + JSON.stringify(err));
680  });
681  ```
682
683### getOsAccountLocalIdFromProcess
684
685getOsAccountLocalIdFromProcess(callback: AsyncCallback<number>): void
686
687获取当前进程所属的系统帐号的帐号ID,使用callback回调异步返回结果。
688
689**系统能力:** SystemCapability.Account.OsAccount
690
691**参数:**
692
693| 参数名   | 类型                        | 必填 | 说明                                               |
694| -------- | --------------------------- | ---- | -------------------------------------------------- |
695| callback | AsyncCallback<number> | 是   | 回调结果,返回的是当前进程所属的系统帐号的帐号ID。 |
696
697**示例:**
698
699  ```js
700  const accountManager = account_osAccount.getAccountManager();
701  accountManager.getOsAccountLocalIdFromProcess((err, accountID) => {
702    console.log("getOsAccountLocalIdFromProcess err: " + JSON.stringify(err));
703    console.log('getOsAccountLocalIdFromProcess accountID: ' + accountID);
704  });
705  ```
706
707### getOsAccountLocalIdFromProcess
708
709getOsAccountLocalIdFromProcess(): Promise<number>
710
711获取当前进程所属的系统帐号的帐号ID,使用Promise方式异步返回结果。
712
713**系统能力:** SystemCapability.Account.OsAccount
714
715**返回值:**
716
717| 类型                  | 说明                                                         |
718| :-------------------- | :----------------------------------------------------------- |
719| Promise<number> | Promise实例,用于获取异步返回结果,返回的是当前进程所属的系统帐号的帐号ID。 |
720
721**示例:**
722
723  ```js
724  const accountManager = account_osAccount.getAccountManager();
725  accountManager.getOsAccountLocalIdFromProcess().then((accountID) => {
726    console.log('getOsAccountLocalIdFromProcess, accountID: ' + accountID);
727  }).catch((err) => {
728    console.log("getOsAccountLocalIdFromProcess err: "  + JSON.stringify(err));
729  });
730  ```
731
732### getOsAccountLocalIdFromUid
733
734getOsAccountLocalIdFromUid(uid: number, callback: AsyncCallback<number>): void
735
736从进程uid中获取该uid所属的系统帐号的帐号ID,使用callback回调异步返回结果。
737
738**系统能力:** SystemCapability.Account.OsAccount
739
740**参数:**
741
742| 参数名   | 类型                        | 必填 | 说明                                          |
743| -------- | --------------------------- | ---- | --------------------------------------------- |
744| uid      | number                      | 是   | 进程uid。                                     |
745| callback | AsyncCallback<number> | 是   | 回调结果,返回的是uid所属的系统帐号的帐号ID。 |
746
747**示例:**查询值为12345678的uid所属的系统帐号的帐号ID
748
749  ```js
750  const accountManager = account_osAccount.getAccountManager();
751  let uid = 12345678;
752  accountManager.getOsAccountLocalIdFromUid(uid, (err, accountID) => {
753    console.log("getOsAccountLocalIdFromUid err: " + JSON.stringify(err));
754    console.log('getOsAccountLocalIdFromUid: ' + accountID);
755  });
756  ```
757
758### getOsAccountLocalIdFromUid
759
760getOsAccountLocalIdFromUid(uid: number): Promise<number>
761
762从进程uid中获取该uid所属的系统帐号的帐号ID,使用Promise方式异步返回结果。
763
764**系统能力:** SystemCapability.Account.OsAccount
765
766**参数:**
767
768| 参数名 | 类型   | 必填 | 说明      |
769| ------ | ------ | ---- | --------- |
770| uid    | number | 是   | 进程uid。 |
771
772**返回值:**
773
774| 类型                  | 说明                                                         |
775| :-------------------- | :----------------------------------------------------------- |
776| Promise<number> | Promise实例,用于获取异步返回结果,返回的是uid所属的系统帐号的帐号ID。 |
777
778**示例:**查询值为12345678的uid所属的系统帐号的帐号ID
779
780  ```js
781  const accountManager = account_osAccount.getAccountManager();
782  let uid = 12345678;
783  accountManager.getOsAccountLocalIdFromUid(uid).then((accountID) => {
784    console.log('getOsAccountLocalIdFromUid: ' + accountID);
785  }).catch((err) => {
786    console.log("getOsAccountLocalIdFromUid err: "  + JSON.stringify(err));
787  });
788  ```
789
790### getOsAccountLocalIdFromDomain<sup>8+</sup>
791
792getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback&lt;number&gt;): void
793
794根据域帐号信息,获取与其关联的系统帐号的帐号ID。
795
796**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
797
798**系统能力:** SystemCapability.Account.OsAccount
799
800**参数:**
801
802| 参数名     | 类型                                    | 必填 | 说明                                         |
803| ---------- | --------------------------------------- | ---- | -------------------------------------------- |
804| domainInfo | [DomainAccountInfo](#domainaccountinfo8) | 是   | 域帐号信息。                                 |
805| callback   | AsyncCallback&lt;number&gt;             | 是   | 回调结果,返回的是和域帐号关联的系统帐号ID。 |
806
807**示例:**
808
809  ```js
810  var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
811  const accountManager = account_osAccount.getAccountManager();
812  accountManager.getOsAccountLocalIdFromDomain(domainInfo, (err, accountID) => {
813    console.log("getOsAccountLocalIdFromDomain: " + JSON.stringify(err));
814    console.log('getOsAccountLocalIdFromDomain: ' + accountID);
815  });
816  ```
817
818### getOsAccountLocalIdFromDomain<sup>8+</sup>
819
820getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo): Promise&lt;number&gt;
821
822根据域帐号信息,获取与其关联的系统帐号的帐号ID,使用Promise方式异步返回结果。
823
824**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
825
826**系统能力:** SystemCapability.Account.OsAccount
827
828**参数:**
829
830| 参数名     | 类型                                    | 必填 | 说明         |
831| ---------- | --------------------------------------- | ---- | ------------ |
832| domainInfo | [DomainAccountInfo](#domainaccountinfo8) | 是   | 域帐号信息。 |
833
834**返回值:**
835
836| 类型                  | 说明                                                         |
837| :-------------------- | :----------------------------------------------------------- |
838| Promise&lt;number&gt; | Promise实例,用于获取异步返回结果,返回的是和域帐号关联的系统帐号ID。 |
839
840**示例:**
841
842  ```js
843  const accountManager = account_osAccount.getAccountManager();
844  var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
845  accountManager.getOsAccountLocalIdFromDomain(domainInfo).then((accountID) => {
846    console.log('getOsAccountLocalIdFromDomain: ' + accountID);
847  }).catch((err) => {
848    console.log("getOsAccountLocalIdFromDomain err: "  + JSON.stringify(err));
849  });
850  ```
851
852### queryMaxOsAccountNumber
853
854queryMaxOsAccountNumber(callback: AsyncCallback&lt;number&gt;): void
855
856查询允许创建的系统帐号的最大数量,使用callback回调异步返回结果。
857
858此接口为系统接口,三方应用不支持调用。
859
860**系统能力:** SystemCapability.Account.OsAccount
861
862**参数:**
863
864| 参数名   | 类型                        | 必填 | 说明                                             |
865| -------- | --------------------------- | ---- | ------------------------------------------------ |
866| callback | AsyncCallback&lt;number&gt; | 是   | 回调结果,返回的是允许创建的系统帐号的最大数量。 |
867
868**示例:**
869
870  ```js
871  const accountManager = account_osAccount.getAccountManager();
872  accountManager.queryMaxOsAccountNumber((err, maxCnt)=>{
873    console.log("queryMaxOsAccountNumber err:" + JSON.stringify(err));
874    console.log("queryMaxOsAccountNumber maxCnt:" + maxCnt);
875  });
876  ```
877
878### queryMaxOsAccountNumber
879
880queryMaxOsAccountNumber(): Promise&lt;number&gt;
881
882查询允许创建的系统帐号的最大数量,使用Promise方式异步返回结果。
883
884此接口为系统接口,三方应用不支持调用。
885
886**系统能力:** SystemCapability.Account.OsAccount
887
888**返回值:**
889
890| 类型                  | 说明                                                         |
891| :-------------------- | :----------------------------------------------------------- |
892| Promise&lt;number&gt; | Promise实例,用于获取异步返回结果,返回的是允许创建的系统帐号的最大数量。 |
893
894**示例:**
895
896  ```js
897  const accountManager = account_osAccount.getAccountManager();
898  accountManager.queryMaxOsAccountNumber().then((maxCnt) => {
899    console.log('queryMaxOsAccountNumber, maxCnt: ' + maxCnt);
900  }).catch((err) => {
901    console.log("queryMaxOsAccountNumber err: "  + JSON.stringify(err));
902  });
903  ```
904
905### getOsAccountAllConstraints
906
907getOsAccountAllConstraints(localId: number, callback: AsyncCallback&lt;Array&lt;string&gt;&gt;): void
908
909获取指定系统帐号的全部约束,使用callback回调异步返回结果。
910
911**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
912
913**系统能力:** SystemCapability.Account.OsAccount
914
915**参数:**
916
917| 参数名   | 类型                                     | 必填 | 说明                                                         |
918| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
919| localId  | number                                   | 是   | 系统帐号ID。                                                 |
920| callback | AsyncCallback&lt;Array&lt;string&gt;&gt; | 是   | 回调结果,返回的是该系统帐号的全部[约束](#系统帐号约束列表)。 |
921
922**示例:**获取ID为100的系统帐号的全部约束
923
924  ```js
925  const accountManager = account_osAccount.getAccountManager();
926  var localId = 100;
927  accountManager.getOsAccountAllConstraints(localId, (err, constraints)=>{
928    console.log("getOsAccountAllConstraints err:" + JSON.stringify(err));
929    console.log("getOsAccountAllConstraints:" + JSON.stringify(constraints));
930  });
931  ```
932
933### getOsAccountAllConstraints
934
935getOsAccountAllConstraints(localId: number): Promise&lt;Array&lt;string&gt;&gt;
936
937获取指定系统帐号的全部约束,使用Promise方式异步返回结果。
938
939**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
940
941**系统能力:** SystemCapability.Account.OsAccount
942
943**参数:**
944
945| 参数名  | 类型   | 必填 | 说明         |
946| ------- | ------ | ---- | ------------ |
947| localId | number | 是   | 系统帐号ID。 |
948
949**返回值:**
950
951| 类型                               | 说明                                                         |
952| :--------------------------------- | :----------------------------------------------------------- |
953| Promise&lt;Array&lt;string&gt;&gt; | Promise实例,用于获取异步返回结果,返回的是该系统帐号的全部[约束](#系统帐号约束列表)。 |
954
955**示例:**获取ID为100的系统帐号的全部约束
956
957  ```js
958  const accountManager = account_osAccount.getAccountManager();
959  var localId = 100;
960  accountManager.getOsAccountAllConstraints(localId).then((constraints) => {
961    console.log("getOsAccountAllConstraints, constraints: " + constraints);
962  }).catch((err) => {
963    console.log("getOsAccountAllConstraints err: "  + JSON.stringify(err));
964  });
965  ```
966
967### queryAllCreatedOsAccounts
968
969queryAllCreatedOsAccounts(callback: AsyncCallback&lt;Array&lt;OsAccountInfo&gt;&gt;): void
970
971查询已创建的所有系统帐号的信息列表,使用callback回调异步返回结果。
972
973此接口为系统接口,三方应用不支持调用。
974
975**系统能力:** SystemCapability.Account.OsAccount
976
977**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
978
979**参数:**
980
981| 参数名   | 类型                                                         | 必填 | 说明                                               |
982| -------- | ------------------------------------------------------------ | ---- | -------------------------------------------------- |
983| callback | AsyncCallback&lt;Array&lt;[OsAccountInfo](#osaccountinfo)&gt;&gt; | 是   | 回调结果,返回的是已创建的所有系统帐号的信息列表。 |
984
985**示例:**
986
987  ```js
988  const accountManager = account_osAccount.getAccountManager();
989  accountManager.queryAllCreatedOsAccounts((err, accountArr)=>{
990    console.log("queryAllCreatedOsAccounts err:" + JSON.stringify(err));
991    console.log("queryAllCreatedOsAccounts accountArr:" + JSON.stringify(accountArr));
992  });
993  ```
994
995### queryAllCreatedOsAccounts
996
997queryAllCreatedOsAccounts(): Promise&lt;Array&lt;OsAccountInfo&gt;&gt;
998
999查询已创建的所有系统帐号的信息列表,使用Promise方式异步返回结果。
1000
1001此接口为系统接口,三方应用不支持调用。
1002
1003**系统能力:** SystemCapability.Account.OsAccount
1004
1005**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1006
1007**返回值:**
1008
1009| 类型                                                        | 说明                                                         |
1010| :---------------------------------------------------------- | :----------------------------------------------------------- |
1011| Promise&lt;Array&lt;[OsAccountInfo](#osaccountinfo)&gt;&gt; | Promise实例,用于获取异步返回结果,返回的是已创建的所有系统帐号的信息列表。 |
1012
1013**示例:**
1014
1015  ```js
1016  const accountManager = account_osAccount.getAccountManager();
1017  accountManager.queryAllCreatedOsAccounts().then((accountArr) => {
1018    console.log('queryAllCreatedOsAccounts, accountArr: ' + JSON.stringify(accountArr));
1019  }).catch((err) => {
1020    console.log("queryAllCreatedOsAccounts err: "  + JSON.stringify(err));
1021  });
1022  ```
1023
1024### queryActivatedOsAccountIds<sup>8+</sup>
1025
1026queryActivatedOsAccountIds(callback: AsyncCallback&lt;Array&lt;number&gt;&gt;): void
1027
1028查询当前处于激活状态的系统帐号的ID列表,使用callback回调异步返回结果。
1029
1030**系统能力:** SystemCapability.Account.OsAccount
1031
1032**参数:**
1033
1034| 参数名   | 类型                                     | 必填 | 说明                                                   |
1035| -------- | ---------------------------------------- | ---- | ------------------------------------------------------ |
1036| callback | AsyncCallback&lt;Array&lt;number&gt;&gt; | 是   | 回调结果,返回的是当前处于激活状态的系统帐号的ID列表。 |
1037
1038**示例:**
1039
1040  ```js
1041  const accountManager = account_osAccount.getAccountManager();
1042  accountManager.queryActivatedOsAccountIds((err, idArray)=>{
1043    console.log("queryActivatedOsAccountIds err:" + JSON.stringify(err));
1044    console.log("queryActivatedOsAccountIds idArray length:" + idArray.length);
1045    for(var i=0;i<idArray.length;i++) {
1046      console.info("activated os account id: " + idArray[i]);
1047    }
1048  });
1049  ```
1050
1051### queryActivatedOsAccountIds<sup>8+</sup>
1052
1053queryActivatedOsAccountIds(): Promise&lt;Array&lt;number&gt;&gt;
1054
1055查询当前处于激活状态的系统帐号的ID列表,使用Promise方式异步返回结果。
1056
1057**系统能力:** SystemCapability.Account.OsAccount
1058
1059**返回值:**
1060
1061| 类型                               | 说明                                                         |
1062| :--------------------------------- | :----------------------------------------------------------- |
1063| Promise&lt;Array&lt;number&gt;&gt; | Promise实例,用于获取异步返回结果,返回的是当前处于激活状态的系统帐号的ID列表。 |
1064
1065**示例:**
1066
1067  ```js
1068  const accountManager = account_osAccount.getAccountManager();
1069  accountManager.queryActivatedOsAccountIds().then((idArray) => {
1070    console.log('queryActivatedOsAccountIds, idArray: ' + idArray);
1071  }).catch((err) => {
1072    console.log("queryActivatedOsAccountIds err: "  + JSON.stringify(err));
1073  });
1074  ```
1075
1076### createOsAccount
1077
1078createOsAccount(localName: string, type: OsAccountType, callback: AsyncCallback&lt;OsAccountInfo&gt;): void
1079
1080创建一个系统帐号,使用callback回调异步返回结果。
1081
1082此接口为系统接口,三方应用不支持调用。
1083
1084**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1085
1086**系统能力:** SystemCapability.Account.OsAccount
1087
1088**参数:**
1089
1090| 参数名    | 类型                                                 | 必填 | 说明                                       |
1091| :-------- | ---------------------------------------------------- | ---- | ------------------------------------------ |
1092| localName | string                                               | 是   | 创建的系统帐号的名称。                     |
1093| type      | [OsAccountType](#osaccounttype)                      | 是   | 创建的系统帐号的类型。                     |
1094| callback  | AsyncCallback&lt;[OsAccountInfo](#osaccountinfo)&gt; | 是   | 回调结果,返回的是新创建的系统帐号的信息。 |
1095
1096**示例:**
1097
1098  ```js
1099  const accountManager = account_osAccount.getAccountManager();
1100  accountManager.createOsAccount("testName", osaccount.OsAccountType.NORMAL, (err, osAccountInfo)=>{
1101    console.log("createOsAccount err:" + JSON.stringify(err));
1102    console.log("createOsAccount osAccountInfo:" + JSON.stringify(osAccountInfo));
1103  });
1104  ```
1105
1106### createOsAccount
1107
1108createOsAccount(localName: string, type: OsAccountType): Promise&lt;OsAccountInfo&gt;
1109
1110创建一个系统帐号,使用Promise方式异步返回结果。
1111
1112此接口为系统接口,三方应用不支持调用。
1113
1114**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1115
1116**系统能力:** SystemCapability.Account.OsAccount
1117
1118**参数:**
1119
1120| 参数名    | 类型                            | 必填 | 说明                   |
1121| --------- | ------------------------------- | ---- | ---------------------- |
1122| localName | string                          | 是   | 创建的系统帐号的名称。 |
1123| type      | [OsAccountType](#osaccounttype) | 是   | 创建的系统帐号的类型。 |
1124
1125**返回值:**
1126
1127| 类型                                           | 说明                                                         |
1128| :--------------------------------------------- | :----------------------------------------------------------- |
1129| Promise&lt;[OsAccountInfo](#osaccountinfo)&gt; | Promise实例,用于获取异步返回结果,返回的是新创建的系统帐号的信息。 |
1130
1131**示例:**
1132
1133  ```js
1134  const accountManager = account_osAccount.getAccountManager();
1135  accountManager.createOsAccount("testAccountName", osaccount.OsAccountType.NORMAL).then((accountInfo) => {
1136    console.log("createOsAccount, accountInfo: " + JSON.stringify(accountInfo));
1137  }).catch((err) => {
1138    console.log("createOsAccount err: "  + JSON.stringify(err));
1139  });
1140  ```
1141
1142### createOsAccountForDomain<sup>8+</sup>
1143
1144createOsAccountForDomain(type: OsAccountType, domainInfo: DomainAccountInfo, callback: AsyncCallback&lt;OsAccountInfo&gt;): void
1145
1146根据域帐号信息,创建一个系统帐号并将其与域帐号关联,使用callback回调异步返回结果。
1147
1148此接口为系统接口,三方应用不支持调用。
1149
1150**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1151
1152**系统能力:** SystemCapability.Account.OsAccount
1153
1154**参数:**
1155
1156| 参数名     | 类型                                                 | 必填 | 说明                                       |
1157| :--------- | ---------------------------------------------------- | ---- | ------------------------------------------ |
1158| type       | [OsAccountType](#osaccounttype)                      | 是   | 创建的系统帐号的类型。                     |
1159| domainInfo | [DomainAccountInfo](#domainaccountinfo8)              | 是   | 域帐号信息。                               |
1160| callback   | AsyncCallback&lt;[OsAccountInfo](#osaccountinfo)&gt; | 是   | 回调结果,返回的是新创建的系统帐号的信息。 |
1161
1162**示例:**
1163
1164  ```js
1165  const accountManager = account_osAccount.getAccountManager();
1166  var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
1167  accountManager.createOsAccountForDomain(osaccount.OsAccountType.NORMAL, domainInfo, (err, osAccountInfo)=>{
1168    console.log("createOsAccountForDomain err:" + JSON.stringify(err));
1169    console.log("createOsAccountForDomain osAccountInfo:" + JSON.stringify(osAccountInfo));
1170  });
1171  ```
1172
1173### createOsAccountForDomain<sup>8+</sup>
1174
1175createOsAccountForDomain(type: OsAccountType, domainInfo: DomainAccountInfo): Promise&lt;OsAccountInfo&gt;
1176
1177根据传入的域帐号信息,创建与其关联的系统帐号,使用Promise方式异步返回结果。
1178
1179此接口为系统接口,三方应用不支持调用。
1180
1181**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1182
1183**系统能力:** SystemCapability.Account.OsAccount
1184
1185**参数:**
1186
1187| 参数名     | 类型                                    | 必填 | 说明                   |
1188| ---------- | --------------------------------------- | ---- | ---------------------- |
1189| type       | [OsAccountType](#osaccounttype)         | 是   | 创建的系统帐号的类型。 |
1190| domainInfo | [DomainAccountInfo](#domainaccountinfo8) | 是   | 域帐号信息。           |
1191
1192**返回值:**
1193
1194| 类型                                           | 说明                                                         |
1195| :--------------------------------------------- | :----------------------------------------------------------- |
1196| Promise&lt;[OsAccountInfo](#osaccountinfo)&gt; | Promise实例,用于获取异步返回结果,返回的是新创建的系统帐号的信息。 |
1197
1198**示例:**
1199
1200  ```js
1201  const accountManager = account_osAccount.getAccountManager();
1202  var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
1203  accountManager.createOsAccountForDomain(osaccount.OsAccountType.NORMAL, domainInfo).then((accountInfo) => {
1204    console.log("createOsAccountForDomain, account info: " + JSON.stringify(accountInfo));
1205  }).catch((err) => {
1206    console.log("createOsAccountForDomain err: "  + JSON.stringify(err));
1207  });
1208  ```
1209
1210### queryCurrentOsAccount
1211
1212queryCurrentOsAccount(callback: AsyncCallback&lt;OsAccountInfo&gt;): void
1213
1214查询当前进程所属的系统帐号的信息,使用callback回调异步返回结果。
1215
1216**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1217
1218**系统能力:** SystemCapability.Account.OsAccount
1219
1220**参数:**
1221
1222| 参数名   | 类型                                                 | 必填 | 说明                                           |
1223| -------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
1224| callback | AsyncCallback&lt;[OsAccountInfo](#osaccountinfo)&gt; | 是   | 回调结果,返回的是当前进程所属的系统帐号信息。 |
1225
1226**示例:**
1227
1228  ```js
1229  const accountManager = account_osAccount.getAccountManager();
1230  accountManager.queryCurrentOsAccount((err, curAccountInfo)=>{
1231    console.log("queryCurrentOsAccount err:" + JSON.stringify(err));
1232    console.log("queryCurrentOsAccount curAccountInfo:" + JSON.stringify(curAccountInfo));
1233  });
1234  ```
1235
1236### queryCurrentOsAccount
1237
1238queryCurrentOsAccount(): Promise&lt;OsAccountInfo&gt;
1239
1240查询当前进程所属的系统帐号的信息,使用Promise方式异步返回结果。
1241
1242**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1243
1244**系统能力:** SystemCapability.Account.OsAccount
1245
1246**返回值:**
1247
1248| 类型                                           | 说明                                                         |
1249| :--------------------------------------------- | :----------------------------------------------------------- |
1250| Promise&lt;[OsAccountInfo](#osaccountinfo)&gt; | Promise实例,用于获取异步返回结果,返回的是当前进程所属的系统帐号信息。 |
1251
1252**示例:**
1253
1254  ```js
1255  const accountManager = account_osAccount.getAccountManager();
1256  accountManager.queryCurrentOsAccount().then((accountInfo) => {
1257    console.log("queryCurrentOsAccount, accountInfo: " + JSON.stringify(accountInfo));
1258  }).catch((err) => {
1259    console.log("queryCurrentOsAccount err: "  + JSON.stringify(err));
1260  });
1261  ```
1262
1263### queryOsAccountById
1264
1265queryOsAccountById(localId: number, callback: AsyncCallback&lt;OsAccountInfo&gt;): void
1266
1267查询指定系统帐号的信息,使用callback回调异步返回结果。
1268
1269此接口为系统接口,三方应用不支持调用。
1270
1271**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTSohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION
1272
1273**系统能力:** SystemCapability.Account.OsAccount
1274
1275**参数:**
1276
1277| 参数名   | 类型                                                 | 必填 | 说明                                     |
1278| -------- | ---------------------------------------------------- | ---- | ---------------------------------------- |
1279| localId  | number                                               | 是   | 要查询的系统帐号的ID                     |
1280| callback | AsyncCallback&lt;[OsAccountInfo](#osaccountinfo)&gt; | 是   | 回调结果,返回的是查到的系统帐号的信息。 |
1281
1282**示例:**查询ID为100的系统帐号信息
1283
1284  ```js
1285  const accountManager = account_osAccount.getAccountManager();
1286  var localId = 100;
1287  accountManager.queryOsAccountById(localId, (err, accountInfo)=>{
1288    console.log("queryOsAccountById err:" + JSON.stringify(err));
1289    console.log("queryOsAccountById accountInfo:" + JSON.stringify(accountInfo));
1290  });
1291  ```
1292
1293### queryOsAccountById
1294
1295queryOsAccountById(localId: number): Promise&lt;OsAccountInfo&gt;
1296
1297查询指定系统帐号的信息,使用Promise方式异步返回结果。
1298
1299此接口为系统接口,三方应用不支持调用。
1300
1301**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTSohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION
1302
1303**系统能力:** SystemCapability.Account.OsAccount
1304
1305**参数:**
1306
1307| 参数名  | 类型   | 必填 | 说明                 |
1308| ------- | ------ | ---- | -------------------- |
1309| localId | number | 是   | 要查询的系统帐号的ID |
1310
1311**返回值:**
1312
1313| 类型                                           | 说明                                                         |
1314| :--------------------------------------------- | :----------------------------------------------------------- |
1315| Promise&lt;[OsAccountInfo](#osaccountinfo)&gt; | Promise实例,用于获取异步返回结果,返回的是查到的系统帐号的信息。 |
1316
1317**示例:**查询ID为100的系统帐号信息
1318
1319  ```js
1320  const accountManager = account_osAccount.getAccountManager();
1321  var localId = 100;
1322  accountManager.queryOsAccountById(localId).then((accountInfo) => {
1323    console.log("queryOsAccountById, accountInfo: " + JSON.stringify(accountInfo));
1324  }).catch((err) => {
1325    console.log("queryOsAccountById err: "  + JSON.stringify(err));
1326  });
1327  ```
1328
1329### getOsAccountTypeFromProcess
1330
1331getOsAccountTypeFromProcess(callback: AsyncCallback&lt;OsAccountType&gt;): void
1332
1333查询当前进程所属的系统帐号的帐号类型,使用callback回调异步返回结果。
1334
1335**系统能力:** SystemCapability.Account.OsAccount
1336
1337**参数:**
1338
1339| 参数名   | 类型                                                 | 必填 | 说明                                                 |
1340| -------- | ---------------------------------------------------- | ---- | ---------------------------------------------------- |
1341| callback | AsyncCallback&lt;[OsAccountType](#osaccounttype)&gt; | 是   | 回调结果,返回的是当前进程所属的系统帐号的帐号类型。 |
1342
1343**示例:**
1344
1345  ```js
1346  const accountManager = account_osAccount.getAccountManager();
1347  accountManager.getOsAccountTypeFromProcess((err, accountType) => {
1348    console.log("getOsAccountTypeFromProcess err: " + JSON.stringify(err));
1349    console.log('getOsAccountTypeFromProcess accountType: ' + accountType);
1350  });
1351  ```
1352
1353### getOsAccountTypeFromProcess
1354
1355getOsAccountTypeFromProcess(): Promise&lt;OsAccountType&gt;
1356
1357查询当前进程所属的系统帐号的帐号类型,使用Promise方式异步返回结果。
1358
1359**系统能力:** SystemCapability.Account.OsAccount
1360
1361**返回值:**
1362
1363| 类型                                           | 说明                                                         |
1364| :--------------------------------------------- | :----------------------------------------------------------- |
1365| Promise&lt;[OsAccountType](#osaccounttype)&gt; | Promise实例,用于获取异步返回结果,返回的是当前进程所属的系统帐号的帐号类型。 |
1366
1367**示例:**
1368
1369  ```js
1370  const accountManager = account_osAccount.getAccountManager();
1371  accountManager.getOsAccountTypeFromProcess().then((accountType) => {
1372    console.log('getOsAccountTypeFromProcess, accountType: ' + accountType);
1373  }).catch((err) => {
1374    console.log("getOsAccountTypeFromProcess err: "  + JSON.stringify(err));
1375  });
1376  ```
1377
1378### getDistributedVirtualDeviceId
1379
1380getDistributedVirtualDeviceId(callback: AsyncCallback&lt;string&gt;): void
1381
1382获取分布式虚拟设备ID,使用callback回调异步返回结果。
1383
1384**需要权限:** ohos.permission.DISTRIBUTED_DATASYNCohos.permission.MANAGE_LOCAL_ACCOUNTS
1385
1386**系统能力:** SystemCapability.Account.OsAccount
1387
1388**参数:**
1389
1390| 参数名   | 类型                        | 必填 | 说明                                 |
1391| -------- | --------------------------- | ---- | ------------------------------------ |
1392| callback | AsyncCallback&lt;string&gt; | 是   | 回调结果,返回的是分布式虚拟设备ID。 |
1393
1394**示例:**
1395
1396  ```js
1397  const accountManager = account_osAccount.getAccountManager();
1398  accountManager.getDistributedVirtualDeviceId((err, virtualID) => {
1399    console.log("getDistributedVirtualDeviceId err: " + JSON.stringify(err));
1400    console.log('getDistributedVirtualDeviceId virtualID: ' + virtualID);
1401  });
1402  ```
1403
1404### getDistributedVirtualDeviceId
1405
1406getDistributedVirtualDeviceId(): Promise&lt;string&gt;
1407
1408获取分布式虚拟设备ID,使用Promise方式异步返回结果。
1409
1410**需要权限:** ohos.permission.DISTRIBUTED_DATASYNCohos.permission.MANAGE_LOCAL_ACCOUNTS
1411
1412**系统能力:** SystemCapability.Account.OsAccount
1413
1414**返回值:**
1415
1416| 类型                  | 说明                                                         |
1417| :-------------------- | :----------------------------------------------------------- |
1418| Promise&lt;string&gt; | Promise实例,用于获取异步返回结果,返回的是分布式虚拟设备ID。 |
1419
1420**示例:**
1421
1422  ```js
1423  const accountManager = account_osAccount.getAccountManager();
1424  accountManager.getDistributedVirtualDeviceId().then((virtualID) => {
1425    console.log('getDistributedVirtualDeviceId, virtualID: ' + virtualID);
1426  }).catch((err) => {
1427    console.log("getDistributedVirtualDeviceId err: "  + JSON.stringify(err));
1428  });
1429  ```
1430
1431### getOsAccountProfilePhoto
1432
1433getOsAccountProfilePhoto(localId: number, callback: AsyncCallback&lt;string&gt;): void
1434
1435获取指定系统帐号的头像信息,使用callback回调异步返回结果。
1436
1437此接口为系统接口,三方应用不支持调用。
1438
1439**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1440
1441**系统能力:** SystemCapability.Account.OsAccount
1442
1443**参数:**
1444
1445| 参数名   | 类型                        | 必填 | 说明                                     |
1446| -------- | --------------------------- | ---- | ---------------------------------------- |
1447| localId  | number                      | 是   | 系统帐号ID。                             |
1448| callback | AsyncCallback&lt;string&gt; | 是   | 回调结果,返回的是该系统帐号的头像信息。 |
1449
1450**示例:**获取ID为100的系统帐号的头像
1451
1452  ```js
1453  const accountManager = account_osAccount.getAccountManager();
1454  var localId = 100;
1455  accountManager.getOsAccountProfilePhoto(localId, (err, photo)=>{
1456    console.log("getOsAccountProfilePhoto err:" + JSON.stringify(err));
1457    console.log("get photo:" + photo + " by localId: " + localId);
1458  });
1459  ```
1460
1461### getOsAccountProfilePhoto
1462
1463getOsAccountProfilePhoto(localId: number): Promise&lt;string&gt;
1464
1465获取指定系统帐号的头像信息,使用Promise方式异步返回结果。
1466
1467此接口为系统接口,三方应用不支持调用。
1468
1469**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1470
1471**系统能力:** SystemCapability.Account.OsAccount
1472
1473**参数:**
1474
1475| 参数名  | 类型   | 必填 | 说明         |
1476| ------- | ------ | ---- | ------------ |
1477| localId | number | 是   | 系统帐号ID。 |
1478
1479**返回值:**
1480
1481| 类型                  | 说明                                                         |
1482| :-------------------- | :----------------------------------------------------------- |
1483| Promise&lt;string&gt; | Promise实例,用于获取异步返回结果,返回的是该系统帐号的头像信息。 |
1484
1485**示例:**获取ID为100的系统帐号的头像
1486
1487  ```js
1488  const accountManager = account_osAccount.getAccountManager();
1489  var localId = 100;
1490  accountManager.getOsAccountProfilePhoto(localId).then((photo) => {
1491    console.log("getOsAccountProfilePhoto: " + photo);
1492  }).catch((err) => {
1493    console.log("getOsAccountProfilePhoto err: "  + JSON.stringify(err));
1494  });
1495  ```
1496
1497### setOsAccountProfilePhoto
1498
1499setOsAccountProfilePhoto(localId: number, photo: string, callback: AsyncCallback&lt;void&gt;): void
1500
1501为指定系统帐号设置头像信息,使用callback回调异步返回结果。
1502
1503此接口为系统接口,三方应用不支持调用。
1504
1505**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1506
1507**系统能力:** SystemCapability.Account.OsAccount
1508
1509**参数:**
1510
1511| 参数名   | 类型                      | 必填 | 说明         |
1512| -------- | ------------------------- | ---- | ------------ |
1513| localId  | number                    | 是   | 系统帐号ID。 |
1514| photo    | string                    | 是   | 头像信息。   |
1515| callback | AsyncCallback&lt;void&gt; | 是   | 回调结果。   |
1516
1517**示例:**给ID为100的系统帐号设置头像
1518
1519  ```js
1520  const accountManager = account_osAccount.getAccountManager();
1521  var localId = 100;
1522  var photo = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAYAAAA/I0V3AAAAAXNSR0IArs4c6QAAAARnQU1BAA"+
1523  "Cxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACwSURBVDhPvZLBDYMwDEV/ugsXRjAT0EHCOuFIBwkbdIRewi6unbiAyoGgSn1SFH85+Y"+
1524  "q/4ljARW62X+LHS8uIzjm4dXUYF+utzBikB52Jo5e5iEPKqpACk7R9NM2RvWm5tIkD2czLCUFNKLD6IjdMHFHDzws285MgGrT0xCtp3WOKHo"+
1525  "+7q0mP0DZW9pNmoEFUzrQjp5cCnaen2kSJXLFD8ghbXyZCMQf/8e8Ns1XVAG/XAgqKzVnJFAAAAABJRU5ErkJggg=="
1526  osAccountManager.setOsAccountProfilePhoto(localId, photo, (err)=>{
1527    console.log("setOsAccountProfilePhoto err:" + JSON.stringify(err));
1528  });
1529  ```
1530
1531### setOsAccountProfilePhoto
1532
1533setOsAccountProfilePhoto(localId: number, photo: string): Promise&lt;void&gt;
1534
1535为指定系统帐号设置头像信息,使用Promise方式异步返回结果。
1536
1537此接口为系统接口,三方应用不支持调用。
1538
1539**需要权限:** ohos.permission.MANAGE_LOCAL_ACCOUNTS
1540
1541**系统能力:** SystemCapability.Account.OsAccount
1542
1543**参数:**
1544
1545| 参数名  | 类型   | 必填 | 说明         |
1546| ------- | ------ | ---- | ------------ |
1547| localId | number | 是   | 系统帐号ID。 |
1548| photo   | string | 是   | 头像信息。   |
1549
1550**返回值:**
1551
1552| 类型                | 说明                                |
1553| :------------------ | :---------------------------------- |
1554| Promise&lt;void&gt; | Promise实例,用于获取异步返回结果。 |
1555
1556**示例:**给ID为100的系统帐号设置头像
1557
1558  ```js
1559  const accountManager = account_osAccount.getAccountManager();
1560  var localId = 100;
1561  var photo = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAYAAAA/I0V3AAAAAXNSR0IArs4c6QAAAARnQU1BAA"+
1562  "Cxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACwSURBVDhPvZLBDYMwDEV/ugsXRjAT0EHCOuFIBwkbdIRewi6unbiAyoGgSn1SFH85+Y"+
1563  "q/4ljARW62X+LHS8uIzjm4dXUYF+utzBikB52Jo5e5iEPKqpACk7R9NM2RvWm5tIkD2czLCUFNKLD6IjdMHFHDzws285MgGrT0xCtp3WOKHo"+
1564  "+7q0mP0DZW9pNmoEFUzrQjp5cCnaen2kSJXLFD8ghbXyZCMQf/8e8Ns1XVAG/XAgqKzVnJFAAAAABJRU5ErkJggg=="
1565  accountManager.setOsAccountProfilePhoto(localId, photo).then(() => {
1566    console.log("setOsAccountProfilePhoto success");
1567  }).catch((err) => {
1568    console.log("setOsAccountProfilePhoto err: "  + JSON.stringify(err));
1569  });
1570  ```
1571
1572### getOsAccountLocalIdBySerialNumber<sup>8+</sup>
1573
1574getOsAccountLocalIdBySerialNumber(serialNumber: number, callback: AsyncCallback&lt;number&gt;): void
1575
1576通过SN码查询与其关联的系统帐号的帐号ID,使用callback回调异步返回结果。
1577
1578**系统能力:** SystemCapability.Account.OsAccount
1579
1580**参数:**
1581
1582| 参数名       | 类型                        | 必填 | 说明                                             |
1583| ------------ | --------------------------- | ---- | ------------------------------------------------ |
1584| serialNumber | number                      | 是   | 帐号SN码。                                       |
1585| callback     | AsyncCallback&lt;number&gt; | 是   | 回调结果,返回的是与SN码关联的系统帐号的帐号ID。 |
1586
1587**示例:**查询与SN码12345关联的系统帐号的ID
1588
1589  ```js
1590  const accountManager = account_osAccount.getAccountManager();
1591  var serialNumber = 12345;
1592  accountManager.getOsAccountLocalIdBySerialNumber(serialNumber, (err, localId)=>{
1593    console.log("ger localId err:" + JSON.stringify(err));
1594    console.log("get localId:" + localId + " by serialNumber: " + serialNumber);
1595  });
1596  ```
1597
1598### getOsAccountLocalIdBySerialNumber<sup>8+</sup>
1599
1600getOsAccountLocalIdBySerialNumber(serialNumber: number): Promise&lt;number&gt;
1601
1602通过SN码查询与其关联的系统帐号的帐号ID,使用Promise方式异步返回结果。
1603
1604**系统能力:** SystemCapability.Account.OsAccount
1605
1606**参数:**
1607
1608| 参数名       | 类型   | 必填 | 说明       |
1609| ------------ | ------ | ---- | ---------- |
1610| serialNumber | number | 是   | 帐号SN码。 |
1611
1612**返回值:**
1613
1614| 类型                  | 说明                                                         |
1615| :-------------------- | :----------------------------------------------------------- |
1616| Promise&lt;number&gt; | Promise实例,用于获取异步返回结果,返回的是与SN码关联的系统帐号的帐号ID。 |
1617
1618**示例:**查询与SN码12345关联的系统帐号的ID
1619
1620  ```js
1621  const accountManager = account_osAccount.getAccountManager();
1622  var serialNumber = 12345;
1623  accountManager.getOsAccountLocalIdBySerialNumber(serialNumber).then((localId) => {
1624    console.log("getOsAccountLocalIdBySerialNumber localId: " + localId);
1625  }).catch((err) => {
1626    console.log("getOsAccountLocalIdBySerialNumber err: "  + JSON.stringify(err));
1627  });
1628  ```
1629
1630### getSerialNumberByOsAccountLocalId<sup>8+</sup>
1631
1632getSerialNumberByOsAccountLocalId(localId: number, callback: AsyncCallback&lt;number&gt;): void
1633
1634通过系统帐号ID获取与该系统帐号关联的SN码,使用callback回调异步返回结果。
1635
1636**系统能力:** SystemCapability.Account.OsAccount
1637
1638**参数:**
1639
1640| 参数名   | 类型                        | 必填 | 说明                                       |
1641| -------- | --------------------------- | ---- | ------------------------------------------ |
1642| localId  | number                      | 是   | 系统帐号ID。                               |
1643| callback | AsyncCallback&lt;number&gt; | 是   | 回调结果,返回的是与该系统帐号关联的SN码。 |
1644
1645**示例:**获取ID为100的系统帐号关联的SN码
1646
1647  ```js
1648  const accountManager = account_osAccount.getAccountManager();
1649  var localId = 100;
1650  accountManager.getSerialNumberByOsAccountLocalId(localId, (err, serialNumber)=>{
1651    console.log("ger serialNumber err:" + JSON.stringify(err));
1652    console.log("get serialNumber:" + serialNumber + " by localId: " + localId);
1653  });
1654  ```
1655
1656### getSerialNumberByOsAccountLocalId<sup>8+</sup>
1657
1658getSerialNumberByOsAccountLocalId(localId: number): Promise&lt;number&gt;
1659
1660通过系统帐号ID获取与该系统帐号关联的SN码,使用Promise方式异步返回结果。
1661
1662**系统能力:** SystemCapability.Account.OsAccount
1663
1664**参数:**
1665
1666| 参数名  | 类型   | 必填 | 说明         |
1667| ------- | ------ | ---- | ------------ |
1668| localId | number | 是   | 系统帐号ID。 |
1669
1670**返回值:**
1671
1672| 类型                  | 说明                                                         |
1673| :-------------------- | :----------------------------------------------------------- |
1674| Promise&lt;number&gt; | Promise实例,用于获取异步返回结果,返回的是与该系统帐号关联的SN码。 |
1675
1676**示例:**获取ID为100的系统帐号关联的SN码
1677
1678  ```js
1679  const accountManager = account_osAccount.getAccountManager();
1680  var localId = 100;
1681  accountManager.getSerialNumberByOsAccountLocalId(localId).then((serialNumber) => {
1682    console.log("getSerialNumberByOsAccountLocalId serialNumber: " + serialNumber);
1683  }).catch((err) => {
1684    console.log("getSerialNumberByOsAccountLocalId err: "  + JSON.stringify(err));
1685  });
1686  ```
1687
1688### on
1689
1690on(type: 'activate' | 'activating', name: string, callback: Callback&lt;number&gt;): void
1691
1692订阅系统帐号的变动信息,使用callback回调异步返回结果。
1693
1694此接口为系统接口,三方应用不支持调用。
1695
1696**需要权限:** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION
1697
1698**系统能力:** SystemCapability.Account.OsAccount
1699
1700**参数:**
1701
1702| 参数名   | 类型                       | 必填 | 说明                                                         |
1703| -------- | -------------------------- | ---- | ------------------------------------------------------------ |
1704| type     | 'activate' \| 'activating' | 是   | 订阅类型,activate表示订阅的是帐号已激活完成的事件,activating表示订阅的是帐号正在激活的事件。 |
1705| name     | string                     | 是   | 订阅名称,可自定义,要求非空且长度不超过1024字节。           |
1706| callback | Callback&lt;number&gt;     | 是   | 订阅系统帐号变动信息的回调,表示当前事件对应的系统帐号ID。   |
1707
1708**示例:**
1709
1710  ```js
1711  const accountManager = account_osAccount.getAccountManager();
1712  function onCallback(receiveLocalId){
1713    console.log("receive localId:" + receiveLocalId);
1714  }
1715  accountManager.on("activating", "osAccountOnOffNameA", onCallback);
1716  ```
1717
1718### off
1719
1720off(type: 'activate' | 'activating', name: string, callback?: Callback&lt;number&gt;): void
1721
1722取消订阅系统帐号的变动信息,使用callback回调异步返回结果。
1723
1724此接口为系统接口,三方应用不支持调用。
1725
1726**需要权限:** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION
1727
1728**系统能力:** SystemCapability.Account.OsAccount
1729
1730**参数:**
1731
1732| 参数名   | 类型                       | 必填 | 说明                                                         |
1733| -------- | -------------------------- | ---- | ------------------------------------------------------------ |
1734| type     | 'activate' \| 'activating' | 是   | 取消订阅类型,activate表示取消订阅帐号已激活完成的事件,activating取消订阅帐号正在激活的事件。 |
1735| name     | string                     | 是   | 订阅名称,可自定义,,要求非空且长度不超过1024字节,需要与订阅接口传入的值保持一致。 |
1736| callback | Callback&lt;number&gt;     | 否   | 取消订阅系统帐号变化的回调,默认返回0。                      |
1737
1738**示例:**
1739
1740  ```js
1741  const accountManager = account_osAccount.getAccountManager();
1742  function offCallback(){
1743    console.log("off enter")
1744  }
1745  accountManager.off("activating", "osAccountOnOffNameA", offCallback);
1746  ```
1747
1748## OsAccountInfo
1749
1750系统帐号信息。
1751
1752**系统能力:** 以下各项对应的系统能力均为SystemCapability.Account.OsAccount1753
1754| 参数名                         | 类型                                                         | 必填 | 说明                              |
1755| ------------------------------ | ------------------------------------------------------------ | ---- | --------------------------------- |
1756| localId                        | number                                                       | 是   | 系统帐号ID。                      |
1757| localName                      | string                                                       | 是   | 系统帐号名称。                    |
1758| type                           | [OsAccountType](#osaccounttype)                              | 是   | 系统帐号类型                      |
1759| constraints                    | Array&lt;string&gt;                                          | 否   | 系统帐号[约束](#系统帐号约束列表) |
1760| isVerified<sup>8+</sup>        | boolean                                                      | 是   | 帐号是否锁屏                      |
1761| photo<sup>8+</sup>             | string                                                       | 否   | 系统帐号头像                      |
1762| createTime<sup>8+</sup>        | number                                                       | 是   | 系统帐号创建时间                  |
1763| lastLoginTime<sup>8+</sup>     | number                                                       | 否   | 系统帐号最后一次登录时间          |
1764| serialNumber<sup>8+</sup>      | number                                                       | 是   | 系统帐号SN码                      |
1765| isActived<sup>8+</sup>         | boolean                                                      | 是   | 系统帐号激活状态                  |
1766| isCreateCompleted<sup>8+</sup> | boolean                                                      | 是   | 系统帐号创建是否完整              |
1767| distributedInfo                | [distributedAccount.DistributedInfo](js-apis-distributed-account.md) | 否   | 分布式帐号信息                    |
1768| domainInfo<sup>8+</sup>        | [DomainAccountInfo](#domainaccountinfo8)                      | 否   | 域帐号信息                        |
1769
1770## DomainAccountInfo<sup>8+</sup>
1771
1772域帐号信息。
1773
1774**系统能力:** 以下各项对应的系统能力均为SystemCapability.Account.OsAccount1775
1776| 参数名      | 类型   | 必填 | 说明       |
1777| ----------- | ------ | ---- | ---------- |
1778| domain      | string | 是   | 域名。     |
1779| accountName | string | 是   | 域帐号名。 |
1780
1781## 系统帐号约束列表
1782
1783| 约束                                  | 说明                           |
1784| ------------------------------------- | ------------------------------ |
1785| constraint.wifi                       | 禁止使用wifi                   |
1786| constraint.wifi.set                   | 禁止配置wifi                   |
1787| constraint.locale.set                 | 禁止配置设备语言               |
1788| constraint.app.accounts               | 禁止添加和删除应用帐号         |
1789| constraint.apps.install               | 禁止安装应用                   |
1790| constraint.apps.uninstall             | 禁止卸载应用                   |
1791| constraint.location.shared            | 禁止打开位置共享               |
1792| constraint.unknown.sources.install    | 禁止安装未知来源的应用         |
1793| constraint.global.unknown.app.install | 禁止所有用户安装未知来源的应用 |
1794| constraint.bluetooth.set              | 禁止配置蓝牙                   |
1795| constraint.bluetooth | 禁止使用蓝牙 |
1796| constraint.bluetooth.share | 禁止共享使用蓝牙 |
1797| constraint.usb.file.transfer | 禁止通过USB传输文件 |
1798| constraint.credentials.set | 禁止配置用户凭据 |
1799| constraint.os.account.remove | 禁止删除用户 |
1800| constraint.managed.profile.remove | 禁止删除此用户的托管配置文件 |
1801| constraint.debug.features.use | J禁止启用或访问调试功能 |
1802| constraint.vpn.set | 禁止配置VPN |
1803| constraint.date.time.set | 禁止配置日期时间和时区 |
1804| constraint.tethering.config | 禁止配置Tethering |
1805| constraint.network.reset | 禁止重置网络设置 |
1806| constraint.factory.reset | 禁止出厂设置 |
1807| constraint.os.account.create | 禁止创建新用户 |
1808| constraint.add.managed.profile | 禁止添加托管配置文件 |
1809| constraint.apps.verify.disable | 强制应用程序验证 |
1810| constraint.cell.broadcasts.set | 禁止配置小区广播 |
1811| constraint.mobile.networks.set | 禁止配置移动网络 |
1812| constraint.control.apps | 禁止在设置或启动模块中修改应用程序 |
1813| constraint.physical.media | 禁止装载物理外部介质 |
1814| constraint.microphone | 禁止使用麦克风 |
1815| constraint.microphone.unmute | 禁止取消麦克风静音 |
1816| constraint.volume.adjust | 禁止调整音量 |
1817| constraint.calls.outgoing | 禁止拨打外呼电话 |
1818| constraint.sms.use | 禁止发送或接收短信 |
1819| constraint.fun | 禁止享受乐趣 |
1820| constraint.windows.create | 禁止创建应用程序窗口以外的窗口 |
1821| constraint.system.error.dialogs | 禁止显示崩溃或无响应应用程序的系统错误对话框 |
1822| constraint.cross.profile.copy.paste | 禁止通过将数据粘贴到其他用户或配置文件来导出剪贴板内容 |
1823| constraint.beam.outgoing | 禁止使用NFC从应用程序传送数据 |
1824| constraint.wallpaper | 禁止管理壁纸 |
1825| constraint.safe.boot | 禁止进入安全引导模式 |
1826| constraint.parent.profile.app.linking | 允许父配置文件中的应用程序处理来自托管配置文件的Web链接 |
1827| constraint.audio.record | 禁止录制音频 |
1828| constraint.camera.use | 禁止使用摄像机 |
1829| constraint.os.account.background.run | 禁止在后台运行 |
1830| constraint.data.roam | 禁止漫游通话时使用蜂窝数据 |
1831| constraint.os.account.set.icon | 禁止修改用户头像 |
1832| constraint.wallpaper.set | 禁止设置壁纸 |
1833| constraint.oem.unlock | 禁止启用oem解锁 |
1834| constraint.device.unmute | 禁止取消设备静音 |
1835| constraint.password.unified | 禁止托管配置文件与主用户进行统一锁屏质询 |
1836| constraint.autofill | 禁止使用自动填充服务 |
1837| constraint.content.capture | 禁止捕获用户屏幕 |
1838| constraint.content.suggestions | 禁止接收内容建议 |
1839| constraint.os.account.start | 禁止切换用户 |
1840| constraint.location.set | 禁止配置位置服务 |
1841| constraint.airplane.mode.set | 禁止飞行模式 |
1842| constraint.brightness.set | 禁止配置亮度 |
1843| constraint.share.into.profile | 禁止将主要用户的文件/图片/数据共享到托管配置文件中 |
1844| constraint.ambient.display | 禁止显示环境 |
1845| constraint.screen.timeout.set | 禁止配置屏幕关闭的超时 |
1846| constraint.print | 禁止打印 |
1847| constraint.private.dns.set | 禁止配置专用DNS |