harmony 鸿蒙@ohos.account.osAccount (系统帐号管理)

2022-08-09 浏览 (1041)

@ohos.account.osAccount (系统帐号管理)

本模块提供管理系统帐号的基础能力，包括系统帐号的添加、删除、查询、设置、订阅、启动等功能。

说明：

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

导入模块

import account_osAccount from '@ohos.account.osAccount';

account_osAccount.getAccountManager

getAccountManager(): AccountManager

获取系统帐号管理对象。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
AccountManager系统帐号管理对象。

示例：

let accountManager = account_osAccount.getAccountManager();

OsAccountType

表示系统帐号类型的枚举。

系统能力： SystemCapability.Account.OsAccount。

名称值说明
ADMIN0管理员帐号。
NORMAL1普通帐号。
GUEST2访客帐号。

AccountManager

系统帐号管理类。

activateOsAccount

activateOsAccount(localId: number, callback: AsyncCallback<void>): void

激活指定系统帐号。使用callback异步回调。

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

需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<void>是回调函数。当帐号激活成功时，err为null，否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.
12300008Restricted Account.
12300009Account has been activated.

示例： 激活ID为100的系统帐号

import { BusinessError } from '@ohos.base';
let localId: number = 100;
try {
  accountManager.activateOsAccount(localId, (err: BusinessError)=>{
    if (err) {
      console.error(`activateOsAccount failed, code is ${err.code}, message is ${err.message}`);
    } else {
      console.log('activateOsAccount successfully');
    }
  });
} catch (err) {
  console.log('activateOsAccount failed, error:' + JSON.stringify(err));
}

activateOsAccount

activateOsAccount(localId: number): Promise<void>

激活指定系统帐号。使用Promise异步回调。

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

需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。

返回值：

类型说明
Promise<void>Promise对象，无返回结果的Promise对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.
12300008Restricted Account.
12300009Account has been activated.

示例： 激活ID为100的系统帐号

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.activateOsAccount(localId).then(() => {
    console.log('activateOsAccount successfully');
  }).catch((err: BusinessError) => {
    console.log('activateOsAccount failed, err:' + JSON.stringify(err));
  });
} catch (e) {
  console.log('activateOsAccount exception: ' + JSON.stringify(e));
}

checkMultiOsAccountEnabled9+

checkMultiOsAccountEnabled(callback: AsyncCallback<boolean>): void

判断是否支持多系统帐号。使用callback异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是回调函数。返回true表示支持多系统帐号；返回false表示不支持。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.checkMultiOsAccountEnabled((err: BusinessError, isEnabled: boolean) => {
    if (err) {
      console.error(`checkMultiOsAccountEnabled failed, code is ${err.code}, message is ${err.message}`);
    } else {
    console.log('checkMultiOsAccountEnabled successfully, isEnabled: ' + isEnabled);
    }
  });
} catch (err) {
  console.log('checkMultiOsAccountEnabled failed, error:' + JSON.stringify(err));
}

checkMultiOsAccountEnabled9+

checkMultiOsAccountEnabled(): Promise<boolean>

判断是否支持多系统帐号。使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示支持多系统帐号；返回false表示不支持。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
try {
  let accountManager = account_osAccount.getAccountManager();
  accountManager.checkMultiOsAccountEnabled().then((isEnabled: boolean) => {
    console.log('checkMultiOsAccountEnabled successfully, isEnabled: ' + isEnabled);
  }).catch((err: BusinessError) => {
    console.error(`checkMultiOsAccountEnabled failed, code is ${err.code}, message is ${err.message}`);
  });
} catch (err) {
  console.log('checkMultiOsAccountEnabled failed, error:' + JSON.stringify(err));
}

checkOsAccountActivated9+

checkOsAccountActivated(localId: number, callback: AsyncCallback<boolean>): void

判断指定系统帐号是否处于激活状态。使用callback异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<boolean>是回调函数。返回true表示帐号已激活；返回false表示帐号未激活。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 判断ID为100的系统帐号是否处于激活状态

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.checkOsAccountActivated(localId, (err: BusinessError, isActivated: boolean) => {
    if (err) {
      console.log('checkOsAccountActivated failed, error:' + JSON.stringify(err));
    } else {
      console.log('checkOsAccountActivated successfully, isActivated:' + isActivated);
    }
  });
} catch (err) {
  console.log('checkOsAccountActivated exception: ' + JSON.stringify(err));
}

checkOsAccountActivated9+

checkOsAccountActivated(localId: number): Promise<boolean>

判断指定系统帐号是否处于激活状态。使用Promise异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示帐号已激活；返回false表示帐号未激活。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 判断ID为100的系统帐号是否处于激活状态

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.checkOsAccountActivated(localId).then((isActivated: boolean) => {
    console.log('checkOsAccountActivated successfully, isActivated: ' + isActivated);
  }).catch((err: BusinessError) => {
    console.log('checkOsAccountActivated failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('checkOsAccountActivated exception: ' + JSON.stringify(err));
}

checkOsAccountConstraintEnabled9+

checkOsAccountConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void

判断指定系统帐号是否具有指定约束。使用callback异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
constraintstring是指定的约束名称。
callbackAsyncCallback<boolean>是回调函数。返回true表示已使能指定的约束；返回false表示未使能指定的约束。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId or constraint.
12300003Account not found.

示例： 判断ID为100的系统帐号是否有禁止使用Wi-Fi的约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
let constraint: string = 'constraint.wifi';
try {
  accountManager.checkOsAccountConstraintEnabled(localId, constraint, (err: BusinessError, isEnabled: boolean)=>{
    if (err) {
      console.log('checkOsAccountConstraintEnabled failed, error: ' + JSON.stringify(err));
    } else {
      console.log('checkOsAccountConstraintEnabled successfully, isEnabled: ' + isEnabled);
    }
  });
} catch (err) {
  console.log('checkOsAccountConstraintEnabled exception: ' + JSON.stringify(err));
}

checkOsAccountConstraintEnabled9+

checkOsAccountConstraintEnabled(localId: number, constraint: string): Promise<boolean>

判断指定系统帐号是否具有指定约束。使用Promise异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
constraintstring是指定的约束名称。

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示已使能指定的约束；返回false表示未使能指定的约束。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId or constraint.
12300003Account not found.

示例： 判断ID为100的系统帐号是否有禁止使用Wi-Fi的约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
let constraint: string = 'constraint.wifi';
try {
  accountManager.checkOsAccountConstraintEnabled(localId, constraint).then((isEnabled: boolean) => {
    console.log('checkOsAccountConstraintEnabled successfully, isEnabled: ' + isEnabled);
  }).catch((err: BusinessError) => {
    console.log('checkOsAccountConstraintEnabled failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('checkOsAccountConstraintEnabled exception: ' + JSON.stringify(err));
}

checkOsAccountTestable9+

checkOsAccountTestable(callback: AsyncCallback<boolean>): void

检查当前系统帐号是否为测试帐号。使用callback异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是回调函数。返回true表示当前帐号为测试帐号；返回false表示当前帐号非测试帐号。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.checkOsAccountTestable((err: BusinessError, isTestable: boolean) => {
    if (err) {
      console.log('checkOsAccountTestable failed, error: ' + JSON.stringify(err));
    } else {
      console.log('checkOsAccountTestable successfully, isTestable: ' + isTestable);
    }
  });
} catch (err) {
  console.log('checkOsAccountTestable error: ' + JSON.stringify(err));
}

checkOsAccountTestable9+

checkOsAccountTestable(): Promise<boolean>

检查当前系统帐号是否为测试帐号。使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示当前帐号为测试帐号；返回false表示当前帐号非测试帐号。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.checkOsAccountTestable().then((isTestable: boolean) => {
    console.log('checkOsAccountTestable successfully, isTestable: ' + isTestable);
  }).catch((err: BusinessError) => {
    console.log('checkOsAccountTestable failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('checkOsAccountTestable exception: ' + JSON.stringify(err));
}

checkOsAccountVerified9+

checkOsAccountVerified(callback: AsyncCallback<boolean>): void

检查当前系统帐号是否已认证解锁。使用callback异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是回调函数。返回true表示当前帐号已认证解锁；返回false表示当前帐号未认证解锁。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.checkOsAccountVerified((err: BusinessError, isVerified: boolean) => {
    if (err) {
      console.log('checkOsAccountVerified failed, error: ' + JSON.stringify(err));
    } else {
      console.log('checkOsAccountVerified successfully, isVerified: ' + isVerified);
    }
  });
} catch (err) {
  console.log('checkOsAccountVerified exception: ' + JSON.stringify(err));
}

checkOsAccountVerified9+

checkOsAccountVerified(): Promise<boolean>

检查当前系统帐号是否已认证解锁。使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示当前帐号已认证解锁；返回false表示当前帐号未认证解锁。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.checkOsAccountVerified().then((isVerified: boolean) => {
    console.log('checkOsAccountVerified successfully, isVerified: ' + isVerified);
  }).catch((err: BusinessError) => {
    console.log('checkOsAccountVerified failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('checkOsAccountVerified exception: ' + JSON.stringify(err));
}

checkOsAccountVerified9+

checkOsAccountVerified(localId: number, callback: AsyncCallback<boolean>): void

检查指定系统帐号是否已验证。使用callback异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<boolean>是回调函数。返回true表示当前帐号已认证解锁；返回false表示当前帐号未认证解锁。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.checkOsAccountVerified(localId, (err: BusinessError, isVerified: boolean) => {
    if (err) {
      console.log('checkOsAccountVerified failed, error: ' + JSON.stringify(err));
    } else {
      console.log('checkOsAccountVerified successfully, isVerified: ' + isVerified);
    }
  });
} catch (err) {
  console.log('checkOsAccountVerified exception: ' + err);
}

checkOsAccountVerified9+

checkOsAccountVerified(localId: number): Promise<boolean>

检查指定系统帐号是否已验证。使用Promise异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。不填则检查当前系统帐号是否已验证。

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示当前帐号已认证解锁；返回false表示当前帐号未认证解锁。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.checkOsAccountVerified(localId).then((isVerified: boolean) => {
    console.log('checkOsAccountVerified successfully, isVerified: ' + isVerified);
  }).catch((err: BusinessError) => {
    console.log('checkOsAccountVerified failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('checkOsAccountVerified exception: ' + JSON.stringify(err));
}

checkOsAccountVerified9+

checkOsAccountVerified(): Promise<boolean>

检查当前系统帐号是否已验证。使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示当前帐号已验证；返回false表示当前帐号未验证。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.checkOsAccountVerified().then((isVerified: boolean) => {
    console.log('checkOsAccountVerified successfully, isVerified: ' + isVerified);
  }).catch((err: BusinessError) => {
    console.log('checkOsAccountVerified failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('checkOsAccountVerified exception: ' + JSON.stringify(err));
}

removeOsAccount

removeOsAccount(localId: number, callback: AsyncCallback<void>): void

删除指定系统帐号。使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<void>是回调函数。如果删除帐号成功，err为null，否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.
12300008Restricted Account.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let accountName: string = 'testAccountName';
try {
  accountManager.createOsAccount(accountName, account_osAccount.OsAccountType.NORMAL,
    (err: BusinessError, osAccountInfo: account_osAccount.OsAccountInfo) => {
      accountManager.removeOsAccount(osAccountInfo.localId, (err: BusinessError)=>{
        if (err) {
          console.log('removeOsAccount failed, error: ' + JSON.stringify(err));
        } else {
          console.log('removeOsAccount successfully');
        }
    });
  });
} catch (err) {
  console.log('removeOsAccount exception: ' + JSON.stringify(err));
}

removeOsAccount

removeOsAccount(localId: number): Promise<void>

删除指定系统帐号。使用Promise异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。

返回值：

类型说明
Promise<void>Promise对象，无返回结果的Promise对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.
12300008Restricted Account.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let accountName: string = 'testAccountName';
try {
  accountManager.createOsAccount(accountName, account_osAccount.OsAccountType.NORMAL,
    (err: BusinessError, osAccountInfo: account_osAccount.OsAccountInfo)=>{
      accountManager.removeOsAccount(osAccountInfo.localId).then(() => {
        console.log('removeOsAccount successfully');
      }).catch((err: BusinessError) => {
          console.log('removeOsAccount failed, error: ' + JSON.stringify(err));
      });
  });
} catch (err) {
  console.log('removeOsAccount exception: ' + JSON.stringify(err));
}

setOsAccountConstraints

setOsAccountConstraints(localId: number, constraints: Array<string>, enable: boolean,callback: AsyncCallback<void>): void

为指定系统帐号设置/删除约束。使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
constraintsArray<string>是待设置/删除的约束列表。
enableboolean是设置(true)/删除(false)
callbackAsyncCallback<void>是回调函数。如果设置成功，err为null，否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId or constraints.
12300003Account not found.
12300008Restricted Account.

示例： 给ID为100的系统帐号设置禁止使用Wi-Fi的约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
let constraint: string = 'constraint.wifi';
try {
  accountManager.setOsAccountConstraints(localId, [constraint], true, (err: BusinessError) => {
    if (err) {
      console.log('setOsAccountConstraints failed, error: ' + JSON.stringify(err));
    } else {
      console.log('setOsAccountConstraints successfully');
    }
  });
} catch (err) {
  console.log('setOsAccountConstraints exception: ' + JSON.stringify(err));
}

setOsAccountConstraints

setOsAccountConstraints(localId: number, constraints: Array<string>, enable: boolean): Promise<void>

为指定系统帐号设置/删除约束。使用Promise异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
constraintsArray<string>是待设置/删除的约束列表。
enableboolean是设置(true)/删除(false)。

返回值：

类型说明
Promise<void>Promise对象，无返回结果的Promise对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId or constraints.
12300003Account not found.
12300008Restricted Account.

示例： 删除ID为100的系统帐号的禁止使用Wi-Fi的约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.setOsAccountConstraints(localId, ['constraint.location.set'], false).then(() => {
    console.log('setOsAccountConstraints succsuccessfully');
  }).catch((err: BusinessError) => {
    console.log('setOsAccountConstraints failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('setOsAccountConstraints exception: ' + JSON.stringify(err));
}

setOsAccountName

setOsAccountName(localId: number, localName: string, callback: AsyncCallback<void>): void

设置指定系统帐号的帐号名。使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
localNamestring是帐号名，最大长度为1024个字符。
callbackAsyncCallback<void>是回调函数。如果设置成功，err为null，否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId or localName.
12300003Account not found.
12300008Restricted Account.

示例： 将ID为100的系统帐号的帐号名设置成demoName

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
let name: string = 'demoName';
try {
  accountManager.setOsAccountName(localId, name, (err: BusinessError) => {
    if (err) {
      console.log('setOsAccountName failed, error: ' + JSON.stringify(err));
    } else {
      console.log('setOsAccountName successfully');
    }
  });
} catch (err) {
  console.log('setOsAccountName exception: ' + JSON.stringify(err));
}

setOsAccountName

setOsAccountName(localId: number, localName: string): Promise<void>

设置指定系统帐号的帐号名。使用Promise异步调用。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
localNamestring是帐号名，最大长度为1024。

返回值：

类型说明
Promise<void>Promise对象，无返回结果的Promise对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId or localName.
12300003Account not found.
12300008Restricted Account.

示例： 将ID为100的系统帐号的帐号名设置成demoName

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
let name: string = 'testName';
try {
  accountManager.setOsAccountName(localId, name).then(() => {
    console.log('setOsAccountName successfully');
  }).catch((err: BusinessError) => {
    console.log('setOsAccountName failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('setOsAccountName exception: ' + JSON.stringify(err));
}

getOsAccountCount9+

getOsAccountCount(callback: AsyncCallback<number>): void

获取已创建的系统帐号数量。使用callback异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<number>是回调函数。当获取成功时，err为null，data为已创建的系统帐号的数量；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getOsAccountCount((err: BusinessError, count: number) => {
    if (err) {
      console.log('getOsAccountCount failed, error: ' + JSON.stringify(err));
    } else {
      console.log('getOsAccountCount successfully, count: ' + count);
    }
  });
} catch (err) {
  console.log('getOsAccountCount exception: ' + JSON.stringify(err));
}

getOsAccountCount9+

getOsAccountCount(): Promise<number>

获取已创建的系统帐号数量。使用Promise异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<number>Promise对象，返回已创建的系统帐号的数量。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getOsAccountCount().then((count: number) => {
    console.log('getOsAccountCount successfully, count: ' + count);
  }).catch((err: BusinessError) => {
    console.log('getOsAccountCount failed, error: ' + JSON.stringify(err));
  });
} catch(err) {
  console.log('getOsAccountCount exception: ' + JSON.stringify(err));
}

getOsAccountLocalId9+

getOsAccountLocalId(callback: AsyncCallback<number>): void

获取当前进程所属的系统帐号ID，使用callback异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<number>是回调函数。当获取成功时，err为null，data为当前进程所属的系统帐号ID；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getOsAccountLocalId((err: BusinessError, localId: number) => {
    if (err) {
      console.log('getOsAccountLocalId failed, error: ' + JSON.stringify(err));
    } else {
      console.log('getOsAccountLocalId successfully, localId: ' + localId);
    }
  });
} catch (err) {
  console.log('getOsAccountLocalId exception: ' + JSON.stringify(err));
}

getOsAccountLocalId9+

getOsAccountLocalId(): Promise<number>

获取当前进程所属的系统帐号ID，使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<number>Promise对象，返回当前进程所属的系统帐号ID。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getOsAccountLocalId().then((localId: number) => {
    console.log('getOsAccountLocalId successfully, localId: ' + localId);
  }).catch((err: BusinessError) => {
    console.log('getOsAccountLocalId failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('getOsAccountLocalId exception: ' + JSON.stringify(err));
}

getOsAccountLocalIdForUid9+

getOsAccountLocalIdForUid(uid: number, callback: AsyncCallback<number>): void

根据uid查询对应的系统帐号ID，使用callback异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
uidnumber是进程uid。
callbackAsyncCallback<number>是回调函数。如果查询成功，err为null，data为对应的系统帐号ID；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid uid.

示例： 查询值为12345678的uid所属的系统帐号的帐号ID

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let uid: number = 12345678;
try {
  accountManager.getOsAccountLocalIdForUid(uid, (err: BusinessError, localId: number) => {
    if (err) {
      console.log('getOsAccountLocalIdForUid failed, error: ' + JSON.stringify(err));
    }
    console.log('getOsAccountLocalIdForUid successfully, localId: ' + localId);
  });
} catch (err) {
  console.log('getOsAccountLocalIdForUid exception: ' + JSON.stringify(err));
}

getOsAccountLocalIdForUid9+

getOsAccountLocalIdForUid(uid: number): Promise<number>

根据uid查询对应的系统帐号ID，使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
uidnumber是进程uid。

返回值：

类型说明
Promise<number>Promise对象，返回指定uid对应的系统帐号ID。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid uid.

示例： 查询值为12345678的uid所属的系统帐号ID

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let uid: number = 12345678;
try {
  accountManager.getOsAccountLocalIdForUid(uid).then((localId: number) => {
    console.log('getOsAccountLocalIdForUid successfully, localId: ' + localId);
  }).catch((err: BusinessError) => {
    console.log('getOsAccountLocalIdForUid failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('getOsAccountLocalIdForUid exception: ' + JSON.stringify(err));
}

getOsAccountLocalIdForUidSync10+

getOsAccountLocalIdForUidSync(uid: number): number

根据uid查询对应的系统帐号ID。使用同步方式返回结果。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
uidnumber是进程uid。

返回值：

类型说明
number返回指定uid对应的系统帐号ID。

错误码：

错误码ID错误信息
12300002Invalid uid.

示例： 查询值为12345678的uid所属的系统帐号ID

let accountManager = account_osAccount.getAccountManager();
let uid: number = 12345678;
try {
  let localId : number = accountManager.getOsAccountLocalIdForUidSync(uid);
  console.log('getOsAccountLocalIdForUidSync successfully, localId: ' + localId);
} catch (err) {
  console.log('getOsAccountLocalIdForUidSync exception: ' + JSON.stringify(err));
}

getOsAccountLocalIdForDomain9+

getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void

根据域帐号信息，获取与其关联的系统帐号ID。使用callback异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainInfoDomainAccountInfo是域帐号信息。
callbackAsyncCallback<number>是回调函数。如果查询成功，err为null，data为域帐号关联的系统帐号ID；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid domainInfo.

示例：

import { BusinessError } from '@ohos.base';
let domainInfo: account_osAccount.DomainAccountInfo = {domain: 'testDomain', accountName: 'testAccountName'};
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getOsAccountLocalIdForDomain(domainInfo, (err: BusinessError, localId: number) => {
    if (err) {
      console.log('getOsAccountLocalIdForDomain failed, error: ' + JSON.stringify(err));
    } else {
      console.log('getOsAccountLocalIdForDomain successfully, localId: ' + localId);
    }
  });
} catch (err) {
  console.log('getOsAccountLocalIdForDomain exception: ' + JSON.stringify(err));
}

getOsAccountLocalIdForDomain9+

getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo): Promise<number>

根据域帐号信息，获取与其关联的系统帐号的帐号ID。使用Promise异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainInfoDomainAccountInfo是域帐号信息。

返回值：

类型说明
Promise<number>Promise对象，返回域帐号关联的系统帐号ID。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid domainInfo.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let domainInfo: account_osAccount.DomainAccountInfo = {domain: 'testDomain', accountName: 'testAccountName'};
try {
  accountManager.getOsAccountLocalIdForDomain(domainInfo).then((localId: number) => {
    console.log('getOsAccountLocalIdForDomain successfully, localId: ' + localId);
  }).catch((err: BusinessError) => {
    console.log('getOsAccountLocalIdForDomain failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('getOsAccountLocalIdForDomain exception: ' + JSON.stringify(err));
}

queryMaxOsAccountNumber

queryMaxOsAccountNumber(callback: AsyncCallback<number>): void

查询允许创建的系统帐号的最大数量。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<number>是回调函数，如果查询成功，err为null，data为允许创建的系统帐号的最大数量；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.queryMaxOsAccountNumber((err: BusinessError, maxCnt: number) => {
    if (err) {
      console.log('queryMaxOsAccountNumber failed, error:' + JSON.stringify(err));
    } else {
      console.log('queryMaxOsAccountNumber successfully, maxCnt:' + maxCnt);
    }
  });
} catch (err) {
  console.log('queryMaxOsAccountNumber exception: ' + JSON.stringify(err));
}

queryMaxOsAccountNumber

queryMaxOsAccountNumber(): Promise<number>

查询允许创建的系统帐号的最大数量。使用Promise异步回调。

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

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<number>Promise对象，返回允许创建的系统帐号的最大数量。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.queryMaxOsAccountNumber().then((maxCnt: number) => {
    console.log('queryMaxOsAccountNumber successfully, maxCnt: ' + maxCnt);
  }).catch((err: BusinessError) => {
    console.log('queryMaxOsAccountNumber failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('queryMaxOsAccountNumber exception: ' + JSON.stringify(err));
}

getOsAccountConstraints9+

getOsAccountConstraints(localId: number, callback: AsyncCallback<Array<string>>): void

获取指定系统帐号的全部约束。使用callback异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<Array<string>>是回调函数，如果获取成功，err为null，data为该系统帐号的全部约束；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 获取ID为100的系统帐号的全部约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.getOsAccountConstraints(localId, (err: BusinessError, constraints: string[]) => {
    if (err) {
      console.log('getOsAccountConstraints failed, err: ' + JSON.stringify(err));
    } else {
      console.log('getOsAccountConstraints successfully, constraints: ' + JSON.stringify(constraints));
    }
  });
} catch (err) {
  console.log('getOsAccountConstraints exception: ' + JSON.stringify(err));
}

getOsAccountConstraints9+

getOsAccountConstraints(localId: number): Promise<Array<string>>

获取指定系统帐号的全部约束。使用Promise异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。

返回值：

类型说明
Promise<Array<string>>Promise对象，返回指定系统帐号的全部约束。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 获取ID为100的系统帐号的全部约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.getOsAccountConstraints(localId).then((constraints: string[]) => {
    console.log('getOsAccountConstraints, constraints: ' + constraints);
  }).catch((err: BusinessError) => {
    console.log('getOsAccountConstraints err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('getOsAccountConstraints exception: ' + JSON.stringify(e));
}

queryAllCreatedOsAccounts

queryAllCreatedOsAccounts(callback: AsyncCallback<Array<OsAccountInfo>>): void

查询已创建的所有系统帐号的信息列表。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

参数：

参数名类型必填说明
callbackAsyncCallback<Array<OsAccountInfo>>是回调函数。如果查询成功，err为null，data为已创建的所有系统帐号的信息列表；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.queryAllCreatedOsAccounts((err: BusinessError, accountArr: account_osAccount.OsAccountInfo[])=>{
    console.log('queryAllCreatedOsAccounts err:' + JSON.stringify(err));
    console.log('queryAllCreatedOsAccounts accountArr:' + JSON.stringify(accountArr));
  });
} catch (e) {
  console.log('queryAllCreatedOsAccounts exception: ' + JSON.stringify(e));
}

queryAllCreatedOsAccounts

queryAllCreatedOsAccounts(): Promise<Array<OsAccountInfo>>

查询已创建的所有系统帐号的信息列表。使用Promise异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

返回值：

类型说明
Promise<Array<OsAccountInfo>>Promise对象，返回已创建的所有系统帐号的信息列表。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.queryAllCreatedOsAccounts().then((accountArr: account_osAccount.OsAccountInfo[]) => {
    console.log('queryAllCreatedOsAccounts, accountArr: ' + JSON.stringify(accountArr));
  }).catch((err: BusinessError) => {
    console.log('queryAllCreatedOsAccounts err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('queryAllCreatedOsAccounts exception: ' + JSON.stringify(e));
}

getActivatedOsAccountLocalIds9+

getActivatedOsAccountLocalIds(callback: AsyncCallback<Array<number>>): void

查询当前处于激活状态的系统帐号的ID列表。使用callback异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<Array<number>>是回调函数。如果查询成功，err为null，data为当前处于激活状态的系统帐号的ID列表；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getActivatedOsAccountLocalIds((err: BusinessError, idArray: number[])=>{
    console.log('getActivatedOsAccountLocalIds err:' + JSON.stringify(err));
    console.log('getActivatedOsAccountLocalIds idArray length:' + idArray.length);
    for(let i=0;i<idArray.length;i++) {
      console.info('activated os account id: ' + idArray[i]);
    }
  });
} catch (e) {
  console.log('getActivatedOsAccountLocalIds exception: ' + JSON.stringify(e));
}

getActivatedOsAccountLocalIds9+

getActivatedOsAccountLocalIds(): Promise<Array<number>>

查询当前处于激活状态的系统帐号的ID列表。使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<Array<number>>Promise对象，返回当前处于激活状态的系统帐号的ID列表。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getActivatedOsAccountLocalIds().then((idArray: number[]) => {
    console.log('getActivatedOsAccountLocalIds, idArray: ' + idArray);
  }).catch((err: BusinessError) => {
    console.log('getActivatedOsAccountLocalIds err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('getActivatedOsAccountLocalIds exception: ' + JSON.stringify(e));
}

createOsAccount

createOsAccount(localName: string, type: OsAccountType, callback: AsyncCallback<OsAccountInfo>): void

创建一个系统帐号。使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localNamestring是创建的系统帐号的名称。
typeOsAccountType是创建的系统帐号的类型。
callbackAsyncCallback<OsAccountInfo>是回调函数。如果创建成功，err为null，data为新创建的系统帐号的信息；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localName or type.
12300005Multi-user not supported.
12300006Unsupported account type.
12300007The number of accounts reaches the upper limit.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.createOsAccount('testName', account_osAccount.OsAccountType.NORMAL,
    (err: BusinessError, osAccountInfo: account_osAccount.OsAccountInfo)=>{
    console.log('createOsAccount err:' + JSON.stringify(err));
    console.log('createOsAccount osAccountInfo:' + JSON.stringify(osAccountInfo));
  });
} catch (e) {
  console.log('createOsAccount exception: ' + JSON.stringify(e));
}

createOsAccount

createOsAccount(localName: string, type: OsAccountType): Promise<OsAccountInfo>

创建一个系统帐号。使用Promise异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localNamestring是创建的系统帐号的名称。
typeOsAccountType是创建的系统帐号的类型。

返回值：

类型说明
Promise<OsAccountInfo>Promise对象，返回新创建的系统帐号的信息。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localName or type.
12300005Multi-user not supported.
12300006Unsupported account type.
12300007The number of accounts reaches the upper limit.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.createOsAccount('testAccountName', account_osAccount.OsAccountType.NORMAL).then(
    (accountInfo: account_osAccount.OsAccountInfo) => {
    console.log('createOsAccount, accountInfo: ' + JSON.stringify(accountInfo));
  }).catch((err: BusinessError) => {
    console.log('createOsAccount err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('createOsAccount exception: ' + JSON.stringify(e));
}

createOsAccountForDomain8+

createOsAccountForDomain(type: OsAccountType, domainInfo: DomainAccountInfo, callback: AsyncCallback<OsAccountInfo>): void

根据域帐号信息，创建一个系统帐号并将其与域帐号关联。使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
typeOsAccountType是创建的系统帐号的类型。
domainInfoDomainAccountInfo是域帐号信息。
callbackAsyncCallback<OsAccountInfo>是回调函数。如果创建成功，err为null，data为新创建的系统帐号的信息；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid type or domainInfo.
12300005Multi-user not supported.
12300006Unsupported account type.
12300007The number of accounts reaches the upper limit.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let domainInfo: account_osAccount.DomainAccountInfo =
  {domain: 'testDomain', accountName: 'testAccountName'};
try {
  accountManager.createOsAccountForDomain(account_osAccount.OsAccountType.NORMAL, domainInfo,
    (err: BusinessError, osAccountInfo: account_osAccount.OsAccountInfo)=>{
    console.log('createOsAccountForDomain err:' + JSON.stringify(err));
    console.log('createOsAccountForDomain osAccountInfo:' + JSON.stringify(osAccountInfo));
  });
} catch (e) {
  console.log('createOsAccountForDomain exception: ' + JSON.stringify(e));
}

createOsAccountForDomain8+

createOsAccountForDomain(type: OsAccountType, domainInfo: DomainAccountInfo): Promise<OsAccountInfo>

根据传入的域帐号信息，创建与其关联的系统帐号。使用Promise异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
typeOsAccountType是创建的系统帐号的类型。
domainInfoDomainAccountInfo是域帐号信息。

返回值：

类型说明
Promise<OsAccountInfo>Promise对象，返回新创建的系统帐号的信息。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid type or domainInfo.
12300005Multi-user not supported.
12300006Unsupported account type.
12300007The number of accounts reaches the upper limit.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let domainInfo: account_osAccount.DomainAccountInfo =
  {domain: 'testDomain', accountName: 'testAccountName'};
try {
  accountManager.createOsAccountForDomain(account_osAccount.OsAccountType.NORMAL, domainInfo).then(
    (accountInfo: account_osAccount.OsAccountInfo) => {
    console.log('createOsAccountForDomain, account info: ' + JSON.stringify(accountInfo));
  }).catch((err: BusinessError) => {
    console.log('createOsAccountForDomain err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('createOsAccountForDomain exception: ' + JSON.stringify(e));
}

getCurrentOsAccount9+

getCurrentOsAccount(callback: AsyncCallback<OsAccountInfo>): void

查询当前进程所属的系统帐号的信息。使用callback异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.GET_LOCAL_ACCOUNTS10+

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<OsAccountInfo>是回调函数。如果查询成功，err为null，data为当前进程所属的系统帐号信息；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getCurrentOsAccount((err: BusinessError, curAccountInfo: account_osAccount.OsAccountInfo)=>{
    console.log('getCurrentOsAccount err:' + JSON.stringify(err));
    console.log('getCurrentOsAccount curAccountInfo:' + JSON.stringify(curAccountInfo));
  });
} catch (e) {
  console.log('getCurrentOsAccount exception: ' + JSON.stringify(e));
}

getCurrentOsAccount9+

getCurrentOsAccount(): Promise<OsAccountInfo>

查询当前进程所属的系统帐号的信息。使用Promise异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.GET_LOCAL_ACCOUNTS10+

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<OsAccountInfo>Promise对象，返回当前进程所属的系统帐号信息。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getCurrentOsAccount().then((accountInfo: account_osAccount.OsAccountInfo) => {
    console.log('getCurrentOsAccount, accountInfo: ' + JSON.stringify(accountInfo));
  }).catch((err: BusinessError) => {
    console.log('getCurrentOsAccount err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('getCurrentOsAccount exception: ' + JSON.stringify(e));
}

queryOsAccountById

queryOsAccountById(localId: number, callback: AsyncCallback<OsAccountInfo>): void

查询指定系统帐号的信息。使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是要查询的系统帐号的ID。
callbackAsyncCallback<OsAccountInfo>是回调函数。如果查询成功，err为null，data为查到的系统帐号的信息；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 查询ID为100的系统帐号信息

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.queryOsAccountById(localId, (err: BusinessError, accountInfo: account_osAccount.OsAccountInfo)=>{
    console.log('queryOsAccountById err:' + JSON.stringify(err));
    console.log('queryOsAccountById accountInfo:' + JSON.stringify(accountInfo));
  });
} catch (e) {
  console.log('queryOsAccountById exception: ' + JSON.stringify(e));
}

queryOsAccountById

queryOsAccountById(localId: number): Promise<OsAccountInfo>

查询指定系统帐号的信息。使用Promise异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是要查询的系统帐号的ID

返回值：

类型说明
Promise<OsAccountInfo>Promise对象，返回查到的系统帐号的信息。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 查询ID为100的系统帐号信息

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.queryOsAccountById(localId).then((accountInfo: account_osAccount.OsAccountInfo) => {
    console.log('queryOsAccountById, accountInfo: ' + JSON.stringify(accountInfo));
  }).catch((err: BusinessError) => {
    console.log('queryOsAccountById err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('queryOsAccountById exception: ' + JSON.stringify(e));
}

getOsAccountType9+

getOsAccountType(callback: AsyncCallback<OsAccountType>): void

查询当前进程所属的系统帐号的帐号类型。使用callback异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<OsAccountType>是回调函数。如果查询成功，err为null，data为当前进程所属的系统帐号的帐号类型；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getOsAccountType((err: BusinessError, accountType: account_osAccount.OsAccountType) => {
    console.log('getOsAccountType err: ' + JSON.stringify(err));
    console.log('getOsAccountType accountType: ' + accountType);
  });
} catch (e) {
  console.log('getOsAccountType exception: ' + JSON.stringify(e));
}

getOsAccountType9+

getOsAccountType(): Promise<OsAccountType>

查询当前进程所属的系统帐号的帐号类型。使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<OsAccountType>Promise对象，返回当前进程所属的系统帐号的帐号类型。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getOsAccountType().then((accountType: account_osAccount.OsAccountType) => {
    console.log('getOsAccountType, accountType: ' + accountType);
  }).catch((err: BusinessError) => {
    console.log('getOsAccountType err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('getOsAccountType exception: ' + JSON.stringify(e));
}

queryDistributedVirtualDeviceId9+

queryDistributedVirtualDeviceId(callback: AsyncCallback<string>): void

获取分布式虚拟设备ID。使用callback异步回调。

需要权限： ohos.permission.DISTRIBUTED_DATASYNC or ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<string>是回调函数。如果获取成功，err为null，data为分布式虚拟设备ID；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.queryDistributedVirtualDeviceId((err: BusinessError, virtualID: string) => {
    console.log('queryDistributedVirtualDeviceId err: ' + JSON.stringify(err));
    console.log('queryDistributedVirtualDeviceId virtualID: ' + virtualID);
  });
} catch (e) {
  console.log('queryDistributedVirtualDeviceId exception: ' + JSON.stringify(e));
}

queryDistributedVirtualDeviceId9+

queryDistributedVirtualDeviceId(): Promise<string>

获取分布式虚拟设备ID。使用Promise异步回调。

需要权限： ohos.permission.DISTRIBUTED_DATASYNC or ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<string>Promise对象，返回分布式虚拟设备ID。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.queryDistributedVirtualDeviceId().then((virtualID: string) => {
    console.log('queryDistributedVirtualDeviceId, virtualID: ' + virtualID);
  }).catch((err: BusinessError) => {
    console.log('queryDistributedVirtualDeviceId err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('queryDistributedVirtualDeviceId exception: ' + JSON.stringify(e));
}

getOsAccountProfilePhoto

getOsAccountProfilePhoto(localId: number, callback: AsyncCallback<string>): void

获取指定系统帐号的头像信息。使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<string>是回调函数。如果获取成功，err为null，data为指定系统帐号的头像信息；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 获取ID为100的系统帐号的头像

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.getOsAccountProfilePhoto(localId, (err: BusinessError, photo: string)=>{
    console.log('getOsAccountProfilePhoto err:' + JSON.stringify(err));
    console.log('get photo:' + photo + ' by localId: ' + localId);
  });
} catch (e) {
  console.log('getOsAccountProfilePhoto exception: ' + JSON.stringify(e));
}

getOsAccountProfilePhoto

getOsAccountProfilePhoto(localId: number): Promise<string>

获取指定系统帐号的头像信息。使用Promise异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。

返回值：

类型说明
Promise<string>Promise对象，返回指定系统帐号的头像信息。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 获取ID为100的系统帐号的头像

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.getOsAccountProfilePhoto(localId).then((photo: string) => {
    console.log('getOsAccountProfilePhoto: ' + photo);
  }).catch((err: BusinessError) => {
    console.log('getOsAccountProfilePhoto err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('getOsAccountProfilePhoto exception: ' + JSON.stringify(e));
}

setOsAccountProfilePhoto

setOsAccountProfilePhoto(localId: number, photo: string, callback: AsyncCallback<void>): void

为指定系统帐号设置头像信息。使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
photostring是头像信息。
callbackAsyncCallback<void>是回调函数。如果设置成功，err为null，否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId or photo.
12300003Account not found.
12300008Restricted Account.

示例： 给ID为100的系统帐号设置头像

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
let photo: string = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAYAAAA/I0V3AAAAAXNSR0IArs4c6QAAAARnQU1BAA'+
'Cxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACwSURBVDhPvZLBDYMwDEV/ugsXRjAT0EHCOuFIBwkbdIRewi6unbiAyoGgSn1SFH85+Y'+
'q/4ljARW62X+LHS8uIzjm4dXUYF+utzBikB52Jo5e5iEPKqpACk7R9NM2RvWm5tIkD2czLCUFNKLD6IjdMHFHDzws285MgGrT0xCtp3WOKHo'+
'+7q0mP0DZW9pNmoEFUzrQjp5cCnaen2kSJXLFD8ghbXyZCMQf/8e8Ns1XVAG/XAgqKzVnJFAAAAABJRU5ErkJggg=='
try {
  accountManager.setOsAccountProfilePhoto(localId, photo, (err: BusinessError)=>{
    console.log('setOsAccountProfilePhoto err:' + JSON.stringify(err));
  });
} catch (e) {
  console.log('setOsAccountProfilePhoto exception: ' + JSON.stringify(e));
}

setOsAccountProfilePhoto

setOsAccountProfilePhoto(localId: number, photo: string): Promise<void>

为指定系统帐号设置头像信息。使用Promise异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
photostring是头像信息。

返回值：

类型说明
Promise<void>Promise对象，无返回结果的Promise对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId or photo.
12300003Account not found.
12300008Restricted Account.

示例： 给ID为100的系统帐号设置头像

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
let photo: string = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAYAAAA/I0V3AAAAAXNSR0IArs4c6QAAAARnQU1BAA'+
'Cxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACwSURBVDhPvZLBDYMwDEV/ugsXRjAT0EHCOuFIBwkbdIRewi6unbiAyoGgSn1SFH85+Y'+
'q/4ljARW62X+LHS8uIzjm4dXUYF+utzBikB52Jo5e5iEPKqpACk7R9NM2RvWm5tIkD2czLCUFNKLD6IjdMHFHDzws285MgGrT0xCtp3WOKHo'+
'+7q0mP0DZW9pNmoEFUzrQjp5cCnaen2kSJXLFD8ghbXyZCMQf/8e8Ns1XVAG/XAgqKzVnJFAAAAABJRU5ErkJggg=='
try {
  accountManager.setOsAccountProfilePhoto(localId, photo).then(() => {
    console.log('setOsAccountProfilePhoto success');
  }).catch((err: BusinessError) => {
    console.log('setOsAccountProfilePhoto err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('setOsAccountProfilePhoto exception: ' + JSON.stringify(e));
}

getOsAccountLocalIdForSerialNumber9+

getOsAccountLocalIdForSerialNumber(serialNumber: number, callback: AsyncCallback<number>): void

通过SN码查询与其关联的系统帐号的帐号ID。使用callback异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
serialNumbernumber是帐号SN码。
callbackAsyncCallback<number>是回调函数。如果成功，err为null，data为与SN码关联的系统帐号的帐号ID；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid serialNumber.
12300003The account indicated by serialNumber dose not exist.

示例： 查询与SN码12345关联的系统帐号的ID

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let serialNumber: number = 12345;
try {
  accountManager.getOsAccountLocalIdForSerialNumber(serialNumber, (err: BusinessError, localId: number)=>{
    console.log('ger localId err:' + JSON.stringify(err));
    console.log('get localId:' + localId + ' by serialNumber: ' + serialNumber);
  });
} catch (e) {
  console.log('ger localId exception: ' + JSON.stringify(e));
}

getOsAccountLocalIdForSerialNumber9+

getOsAccountLocalIdForSerialNumber(serialNumber: number): Promise<number>

通过SN码查询与其关联的系统帐号的帐号ID。使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
serialNumbernumber是帐号SN码。

返回值：

类型说明
Promise<number>Promise对象，返回与SN码关联的系统帐号的帐号ID。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid serialNumber.
12300003The account indicated by serialNumber dose not exist.

示例： 查询与SN码12345关联的系统帐号的ID

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let serialNumber: number = 12345;
try {
  accountManager.getOsAccountLocalIdForSerialNumber(serialNumber).then((localId: number) => {
    console.log('getOsAccountLocalIdForSerialNumber localId: ' + localId);
  }).catch((err: BusinessError) => {
    console.log('getOsAccountLocalIdForSerialNumber err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('getOsAccountLocalIdForSerialNumber exception: ' + JSON.stringify(e));
}

getSerialNumberForOsAccountLocalId9+

getSerialNumberForOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void

通过系统帐号ID获取与该系统帐号关联的SN码。使用callback异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<number>是回调函数。如果获取成功，err为null，data为与该系统帐号关联的SN码；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 获取ID为100的系统帐号关联的SN码

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.getSerialNumberForOsAccountLocalId(localId, (err: BusinessError, serialNumber: number)=>{
    console.log('ger serialNumber err:' + JSON.stringify(err));
    console.log('get serialNumber:' + serialNumber + ' by localId: ' + localId);
  });
} catch (e) {
  console.log('ger serialNumber exception: ' + JSON.stringify(e));
}

getSerialNumberForOsAccountLocalId9+

getSerialNumberForOsAccountLocalId(localId: number): Promise<number>

通过系统帐号ID获取与该系统帐号关联的SN码。使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。

返回值：

类型说明
Promise<number>Promise对象，返回与该系统帐号关联的SN码。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003Account not found.

示例： 获取ID为100的系统帐号关联的SN码

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
try {
  accountManager.getSerialNumberForOsAccountLocalId(localId).then((serialNumber: number) => {
    console.log('getSerialNumberForOsAccountLocalId serialNumber: ' + serialNumber);
  }).catch((err: BusinessError) => {
    console.log('getSerialNumberForOsAccountLocalId err: ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('getSerialNumberForOsAccountLocalId exception: ' + JSON.stringify(e));
}

on

on(type: 'activate'|'activating', name: string, callback: Callback<number>): void

订阅系统帐号的激活完成与激活中的事件。使用callback异步回调。

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

需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
type'activate' |'activating'是订阅类型，activate表示订阅的是帐号已激活完成的事件，activating表示订阅的是帐号正在激活的事件。
namestring是订阅名称，可自定义，要求非空且长度不超过1024字节。
callbackCallback<number>是订阅系统帐号激活完成与激活中的事件回调，表示激活完成后或正在激活中的系统帐号ID。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid type or name.

示例：

let accountManager = account_osAccount.getAccountManager();
function onCallback(receiveLocalId: number){
  console.log('receive localId:' + receiveLocalId);
}
try {
  accountManager.on('activating', 'osAccountOnOffNameA', onCallback);
} catch (e) {
  console.log('receive localId exception: ' + JSON.stringify(e));
}

off

off(type: 'activate'|'activating', name: string, callback?: Callback<number>): void

取消订阅系统帐号的激活完成与激活中的事件。使用callback异步回调。

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

需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
type'activate' |'activating'是取消订阅类型，activate表示取消订阅帐号已激活完成的事件，activating取消订阅帐号正在激活的事件。
namestring是订阅名称，可自定义，要求非空且长度不超过1024字节，需要与订阅接口传入的值保持一致。
callbackCallback<number>否取消订阅系统帐号激活完成与激活中的事件回调，默认为空，表示取消该类型事件的所有回调。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid type or name.

示例：

let accountManager = account_osAccount.getAccountManager();
function offCallback(){
  console.log('off enter')
}
try {
  accountManager.off('activating', 'osAccountOnOffNameA', offCallback);
} catch (e) {
  console.log('off exception: ' + JSON.stringify(e));
}

getBundleIdForUid9+

getBundleIdForUid(uid: number, callback: AsyncCallback<number>): void

通过uid查询对应的bundleId，使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
uidnumber是进程uid。
callbackAsyncCallback<number>是回调函数。如果查询成功，err为null，data为与uid对应的bundleId；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid uid.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let testUid: number = 1000000;
try {
  accountManager.getBundleIdForUid(testUid, (err: BusinessError, bundleId: number) => {
    console.info('getBundleIdForUid errInfo:' + JSON.stringify(err));
    console.info('getBundleIdForUid bundleId:' + JSON.stringify(bundleId));
  });
} catch (e) {
  console.info('getBundleIdForUid exception: ' + JSON.stringify(e));
}

getBundleIdForUid9+

getBundleIdForUid(uid: number): Promise<number>

通过uid查询对应的bundleId，使用Promise异步回调。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
uidnumber是进程uid。

返回值：

类型说明
Promise<number>Promise对象，返回与uid对应的bundleId。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid uid.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let testUid: number = 1000000;
try {
  accountManager.getBundleIdForUid(testUid).then((result: number) => {
    console.info('getBundleIdForUid bundleId:' + JSON.stringify(result));
  }).catch((err: BusinessError) => {
    console.info('getBundleIdForUid errInfo:' + JSON.stringify(err));
  });
} catch (e) {
  console.info('getBundleIdForUid exception: ' + JSON.stringify(e));
}

getBundleIdForUidSync10+

getBundleIdForUidSync(uid: number): number

通过uid查询对应的bundleId。使用同步方式返回结果。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
uidnumber是进程uid。

返回值：

类型说明
number表示与进程uid对应的bundleId。

错误码：

错误码ID错误信息
12300002Invalid uid.

示例：

let accountManager = account_osAccount.getAccountManager();
let testUid: number = 1000000;
try {
  let bundleId : number = accountManager.getBundleIdForUidSync(testUid);
  console.info('getBundleIdForUidSync bundleId:' + bundleId);
} catch (e) {
  console.info('getBundleIdForUidSync exception: ' + JSON.stringify(e));
}

isMainOsAccount9+

isMainOsAccount(callback: AsyncCallback<boolean>): void;

查询当前进程是否处于主用户，使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是回调函数，返回true表示当前帐号为主帐号，返回false表示当前帐号非主帐号。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.isMainOsAccount((err: BusinessError,result: boolean)=>{
    console.info('isMainOsAccount errInfo:' + JSON.stringify(err));
    console.info('isMainOsAccount result:' + JSON.stringify(result));
  });
} catch (e) {
  console.info('isMainOsAccount exception: ' + JSON.stringify(e));
}

isMainOsAccount9+

isMainOsAccount(): Promise<boolean>;

查询当前进程是否处于主用户，使用Promise异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<boolean>Promise对象，返回true表示当前帐号为主帐号，返回false表示当前帐号非主帐号。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.isMainOsAccount().then((result: boolean) => {
    console.info('isMainOsAccount result:' + JSON.stringify(result));
  }).catch((err: BusinessError) => {
    console.info('isMainOsAccount errInfo:' + JSON.stringify(err));
  });
} catch (e) {
  console.info('isMainOsAccount exception: ' + JSON.stringify(e));
}

getOsAccountConstraintSourceTypes9+

getOsAccountConstraintSourceTypes(localId: number, constraint: string, callback: AsyncCallback<Array<ConstraintSourceTypeInfo>>): void;

查询指定系统帐号的指定约束来源信息，使用callback异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是要查询的系统帐号ID
constraintstring是要查询的约束名称
callbackAsyncCallback<Array<ConstraintSourceTypeInfo>>是回调函数。如果成功，err为null，data为指定系统帐号的指定约束来源信息；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid name or constraint.
12300003Account not found.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getOsAccountConstraintSourceTypes(100, 'constraint.wifi',
    (err: BusinessError,sourceTypeInfos: account_osAccount.ConstraintSourceTypeInfo[])=>{
    console.info('getOsAccountConstraintSourceTypes errInfo:' + JSON.stringify(err));
    console.info('getOsAccountConstraintSourceTypes sourceTypeInfos:' + JSON.stringify(sourceTypeInfos));
  });
} catch (e) {
  console.info('getOsAccountConstraintSourceTypes exception: ' + JSON.stringify(e));
}

getOsAccountConstraintSourceTypes9+

getOsAccountConstraintSourceTypes(localId: number, constraint: string): Promise<Array<ConstraintSourceTypeInfo>>;

查询指定系统帐号的指定约束来源信息，使用Promise异步回调。

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

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是要查询的系统帐号ID
constraintstring是要查询的约束名称

返回值：

类型说明
Promise<Array<ConstraintSourceTypeInfo>>Promise对象，返回指定系统帐号的指定约束来源信息。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid name or constraint.
12300003Account not found.

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
try {
  accountManager.getOsAccountConstraintSourceTypes(100, 'constraint.wifi').then(
    (result: account_osAccount.ConstraintSourceTypeInfo[]) => {
    console.info('getOsAccountConstraintSourceTypes sourceTypeInfos:' + JSON.stringify(result));
  }).catch((err: BusinessError) => {
    console.info('getOsAccountConstraintSourceTypes errInfo:' + JSON.stringify(err));
  });
} catch (e) {
  console.info('getOsAccountConstraintSourceTypes exception: ' + JSON.stringify(e));
}

isMultiOsAccountEnable(deprecated)

isMultiOsAccountEnable(callback: AsyncCallback<boolean>): void

判断是否支持多系统帐号。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用checkMultiOsAccountEnabled。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是回调函数。返回true表示支持多系统帐号；返回false表示不支持。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.isMultiOsAccountEnable((err: BusinessError, isEnabled: boolean) => {
  if (err) {
    console.log('isMultiOsAccountEnable failed, error: ' + JSON.stringify(err));
  } else {
  console.log('isMultiOsAccountEnable successfully, isEnabled: ' + isEnabled);
  }
});

isMultiOsAccountEnable(deprecated)

isMultiOsAccountEnable(): Promise<boolean>

判断是否支持多系统帐号。使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用checkMultiOsAccountEnabled。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示支持多系统帐号；返回false表示不支持。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.isMultiOsAccountEnable().then((isEnabled: boolean) => {
  console.log('isMultiOsAccountEnable successfully, isEnabled: ' + isEnabled);
}).catch((err: BusinessError) => {
  console.log('isMultiOsAccountEnable failed, error: ' + JSON.stringify(err));
});

isOsAccountActived(deprecated)

isOsAccountActived(localId: number, callback: AsyncCallback<boolean>): void

判断指定系统帐号是否处于激活状态。使用callback异步回调。

说明：

从 API version 7开始支持从API version 9开始废弃, 建议使用checkOsAccountActivated。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<boolean>是回调函数。返回true表示帐号已激活；返回false表示帐号未激活。

示例： 判断ID为100的系统帐号是否处于激活状态

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
accountManager.isOsAccountActived(localId, (err: BusinessError, isActived: boolean) => {
  if (err) {
    console.log('isOsAccountActived failed, err:' + JSON.stringify(err));
  } else {
    console.log('isOsAccountActived successfully, isActived:' + isActived);
  }
});

isOsAccountActived(deprecated)

isOsAccountActived(localId: number): Promise<boolean>

判断指定系统帐号是否处于激活状态。使用Promise异步回调。

说明：

从 API version 7开始支持从API version 9开始废弃, 建议使用checkOsAccountActivated。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示帐号已激活；返回false表示帐号未激活。

示例： 判断ID为100的系统帐号是否处于激活状态

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
accountManager.isOsAccountActived(localId).then((isActived: boolean) => {
  console.log('isOsAccountActived successfully, isActived: ' + isActived);
}).catch((err: BusinessError) => {
  console.log('isOsAccountActived failed, error: ' + JSON.stringify(err));
});

isOsAccountConstraintEnable(deprecated)

isOsAccountConstraintEnable(localId: number, constraint: string, callback: AsyncCallback<boolean>): void

判断指定系统帐号是否具有指定约束。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用checkOsAccountConstraintEnabled。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
constraintstring是指定的约束名称。
callbackAsyncCallback<boolean>是回调函数。返回true表示已使能指定的约束；返回false表示未使能指定的约束。

示例： 判断ID为100的系统帐号是否有禁止使用Wi-Fi的约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
let constraint: string = 'constraint.wifi';
accountManager.isOsAccountConstraintEnable(localId, constraint, (err: BusinessError, isEnabled: boolean) => {
  if (err) {
    console.log('isOsAccountConstraintEnable failed, error: ' + JSON.stringify(err));
  } else {
    console.log('isOsAccountConstraintEnable successfully, isEnabled: ' + isEnabled);
  }
});

isOsAccountConstraintEnable(deprecated)

isOsAccountConstraintEnable(localId: number, constraint: string): Promise<boolean>

判断指定系统帐号是否具有指定约束。使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用checkOsAccountConstraintEnabled。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
constraintstring是指定的约束名称。

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示已使能指定的约束；返回false表示未使能指定的约束。

示例： 判断ID为100的系统帐号是否有禁止使用Wi-Fi的约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
let constraint: string = 'constraint.wifi';
accountManager.isOsAccountConstraintEnable(localId, constraint).then((isEnabled: boolean) => {
  console.log('isOsAccountConstraintEnable successfully, isEnabled: ' + isEnabled);
}).catch((err: BusinessError) => {
  console.log('isOsAccountConstraintEnable err: ' + JSON.stringify(err));
});

isTestOsAccount(deprecated)

isTestOsAccount(callback: AsyncCallback<boolean>): void

检查当前系统帐号是否为测试帐号。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用checkOsAccountTestable。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是回调函数。返回true表示当前帐号为测试帐号；返回false表示当前帐号非测试帐号。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.isTestOsAccount((err: BusinessError, isTestable: boolean) => {
  if (err) {
    console.log('isTestOsAccount failed, error: ' + JSON.stringify(err));
  } else {
    console.log('isTestOsAccount successfully, isTestable: ' + isTestable);
  }
});

isTestOsAccount(deprecated)

isTestOsAccount(): Promise<boolean>

检查当前系统帐号是否为测试帐号。使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用checkOsAccountTestable。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示当前帐号为测试帐号；返回false表示当前帐号非测试帐号。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
  accountManager.isTestOsAccount().then((isTestable: boolean) => {
    console.log('isTestOsAccount successfully, isTestable: ' + isTestable);
  }).catch((err: BusinessError) => {
    console.log('isTestOsAccount failed, error: ' + JSON.stringify(err));
});

isOsAccountVerified(deprecated)

isOsAccountVerified(callback: AsyncCallback<boolean>): void

检查当前系统帐号是否已验证。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用checkOsAccountVerified。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是回调函数。返回true表示指定帐号已验证；返回false表示指定帐号未验证。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified((err: BusinessError, isVerified: boolean) => {
  if (err) {
    console.log('isOsAccountVerified failed, error: ' + JSON.stringify(err));
  } else {
    console.log('isOsAccountVerified successfully, isVerified: ' + isVerified);
  }
});

isOsAccountVerified(deprecated)

isOsAccountVerified(localId: number, callback: AsyncCallback<boolean>): void

检查指定系统帐号是否已验证。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用checkOsAccountVerified。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<boolean>是回调函数。返回true表示指定帐号已验证；返回false表示指定帐号未验证。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
accountManager.isOsAccountVerified(localId, (err: BusinessError, isVerified: boolean) => {
  if (err) {
    console.log('isOsAccountVerified failed, error: ' + JSON.stringify(err));
  } else {
    console.log('isOsAccountVerified successfully, isVerified: ' + isVerified);
  }
});

isOsAccountVerified(deprecated)

isOsAccountVerified(localId?: number): Promise<boolean>

检查指定系统帐号是否已验证。使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用checkOsAccountVerified。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber否系统帐号ID。不填则检查当前系统帐号是否已验证。

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示指定帐号已验证；返回false表示指定帐号未验证。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified(localId).then((isVerified: boolean) => {
  console.log('isOsAccountVerified successfully, isVerified: ' + isVerified);
}).catch((err: BusinessError) => {
  console.log('isOsAccountVerified failed, error: ' + JSON.stringify(err));
});

getCreatedOsAccountsCount(deprecated)

getCreatedOsAccountsCount(callback: AsyncCallback<number>): void

获取已创建的系统帐号数量。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountCount。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<number>是回调函数。当获取成功时，err为null，data为已创建的系统帐号的数量；否则为错误对象。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.getCreatedOsAccountsCount((err: BusinessError, count: number)=>{
  if (err) {
    console.log('getCreatedOsAccountsCount failed, error: ' + JSON.stringify(err));
  } else {
    console.log('getCreatedOsAccountsCount successfully, count: ' + count);
  }
});

getCreatedOsAccountsCount(deprecated)

getCreatedOsAccountsCount(): Promise<number>

获取已创建的系统帐号数量，使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountCount。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<number>Promise对象，返回已创建的系统帐号的数量。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.getCreatedOsAccountsCount().then((count: number) => {
  console.log('getCreatedOsAccountsCount successfully, count: ' + count);
}).catch((err: BusinessError) => {
  console.log('getCreatedOsAccountsCount failed, error: ' + JSON.stringify(err));
});

getOsAccountLocalIdFromProcess(deprecated)

getOsAccountLocalIdFromProcess(callback: AsyncCallback<number>): void

获取当前进程所属的系统帐号ID，使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountLocalId。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<number>是回调函数。当获取成功时，err为null，data为当前进程所属的系统帐号ID；否则为错误对象。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromProcess((err: BusinessError, localId: number) => {
  if (err) {
    console.log('getOsAccountLocalIdFromProcess failed, error: ' + JSON.stringify(err));
  } else {
    console.log('getOsAccountLocalIdFromProcess failed, error: ' + localId);
  }
});

getOsAccountLocalIdFromProcess(deprecated)

getOsAccountLocalIdFromProcess(): Promise<number>

获取当前进程所属的系统帐号ID，使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountLocalId。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<number>Promise对象，返回当前进程所属的系统帐号ID。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromProcess().then((localId: number) => {
  console.log('getOsAccountLocalIdFromProcess successfully, localId: ' + localId);
}).catch((err: BusinessError) => {
  console.log('getOsAccountLocalIdFromProcess failed, error: ' + JSON.stringify(err));
});

getOsAccountLocalIdFromUid(deprecated)

getOsAccountLocalIdFromUid(uid: number, callback: AsyncCallback<number>): void

根据uid查询对应的系统帐号ID。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountLocalIdForUid。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
uidnumber是进程uid。
callbackAsyncCallback<number>是回调函数。如果查询成功，err为null，data为对应的系统帐号ID；否则为错误对象。

示例： 查询值为12345678的uid所属的系统帐号ID

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let uid: number = 12345678;
accountManager.getOsAccountLocalIdFromUid(uid, (err: BusinessError, localId: number) => {
  if (err) {
    console.log('getOsAccountLocalIdFromUid failed, error: ' + JSON.stringify(err));
  } else {
    console.log('getOsAccountLocalIdFromUid successfully, localId: ' + localId);
  }
});

getOsAccountLocalIdFromUid(deprecated)

getOsAccountLocalIdFromUid(uid: number): Promise<number>

根据uid查询对应的系统帐号ID，使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountLocalIdForUid。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
uidnumber是进程uid。

返回值：

类型说明
Promise<number>Promise对象，返回uid对应的系统帐号ID。

示例： 查询值为12345678的uid所属的系统帐号ID

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let uid: number = 12345678;
accountManager.getOsAccountLocalIdFromUid(uid).then((localId: number) => {
  console.log('getOsAccountLocalIdFromUid successfully, localId: ' + localId);
}).catch((err: BusinessError) => {
  console.log('getOsAccountLocalIdFromUid failed, error: ' + JSON.stringify(err));
});

getOsAccountLocalIdFromDomain(deprecated)

getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void

根据域帐号信息，获取与其关联的系统帐号的帐号ID。使用callback异步回调。

说明：

从 API version 8开始支持，从API version 9开始废弃。建议使用getOsAccountLocalIdForDomain。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainInfoDomainAccountInfo是域帐号信息。
callbackAsyncCallback<number>是回调函数，如果获取成功，err为null，data为域帐号关联的系统帐号ID；否则为错误对象。

示例：

import { BusinessError } from '@ohos.base';
let domainInfo: account_osAccount.DomainAccountInfo = {domain: 'testDomain', accountName: 'testAccountName'};
let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromDomain(domainInfo, (err: BusinessError, localId: number) => {
  if (err) {
    console.log('getOsAccountLocalIdFromDomain failed, error: ' + JSON.stringify(err));
  } else {
    console.log('getOsAccountLocalIdFromDomain successfully, localId: ' + localId);
  }
});

getOsAccountLocalIdFromDomain(deprecated)

getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo): Promise<number>

根据域帐号信息，获取与其关联的系统帐号的帐号ID。使用Promise异步回调。

说明：

从 API version 8开始支持，从API version 9开始废弃。建议使用getOsAccountLocalIdForDomain。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainInfoDomainAccountInfo是域帐号信息。

返回值：

类型说明
Promise<number>Promise对象，返回域帐号关联的系统帐号ID。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let domainInfo: account_osAccount.DomainAccountInfo = {domain: 'testDomain', accountName: 'testAccountName'};
accountManager.getOsAccountLocalIdFromDomain(domainInfo).then((localId: number) => {
  console.log('getOsAccountLocalIdFromDomain successfully, localId: ' + localId);
}).catch((err: BusinessError) => {
  console.log('getOsAccountLocalIdFromDomain failed, error: ' + JSON.stringify(err));
});

getOsAccountAllConstraints(deprecated)

getOsAccountAllConstraints(localId: number, callback: AsyncCallback<Array<string>>): void

获取指定系统帐号的全部约束。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountConstraints。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<Array<string>>是回调函数。如果获取成功，err为null，data为指定系统帐号的全部约束；否则为错误对象。

示例： 获取ID为100的系统帐号的全部约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
accountManager.getOsAccountAllConstraints(localId, (err: BusinessError, constraints: string[])=>{
  console.log('getOsAccountAllConstraints err:' + JSON.stringify(err));
  console.log('getOsAccountAllConstraints:' + JSON.stringify(constraints));
});

getOsAccountAllConstraints(deprecated)

getOsAccountAllConstraints(localId: number): Promise<Array<string>>

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountConstraints。

获取指定系统帐号的全部约束。使用Promise异步回调。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。

返回值：

类型说明
Promise<Array<string>>Promise对象，返回指定系统帐号的全部约束。

示例： 获取ID为100的系统帐号的全部约束

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
accountManager.getOsAccountAllConstraints(localId).then((constraints: string[]) => {
  console.log('getOsAccountAllConstraints, constraints: ' + constraints);
}).catch((err: BusinessError) => {
  console.log('getOsAccountAllConstraints err: ' + JSON.stringify(err));
});

queryActivatedOsAccountIds(deprecated)

queryActivatedOsAccountIds(callback: AsyncCallback<Array<number>>): void

查询当前处于激活状态的系统帐号的ID列表。使用callback异步回调。

说明：

从 API version 8开始支持，从API version 9开始废弃。建议使用getActivatedOsAccountLocalIds。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<Array<number>>是回调函数。如果查询成功，err为null，data为当前处于激活状态的系统帐号的ID列表；否则为错误对象。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.queryActivatedOsAccountIds((err: BusinessError, idArray: number[])=>{
  console.log('queryActivatedOsAccountIds err:' + JSON.stringify(err));
  console.log('queryActivatedOsAccountIds idArray length:' + idArray.length);
  for(let i=0;i<idArray.length;i++) {
    console.info('activated os account id: ' + idArray[i]);
  }
});

queryActivatedOsAccountIds(deprecated)

queryActivatedOsAccountIds(): Promise<Array<number>>

说明：

从 API version 8开始支持，从API version 9开始废弃。建议使用getActivatedOsAccountLocalIds。

查询当前处于激活状态的系统帐号的ID列表。使用Promise异步回调。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<Array<number>>Promise对象，返回当前处于激活状态的系统帐号的ID列表。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.queryActivatedOsAccountIds().then((idArray: number[]) => {
  console.log('queryActivatedOsAccountIds, idArray: ' + idArray);
}).catch((err: BusinessError) => {
  console.log('queryActivatedOsAccountIds err: ' + JSON.stringify(err));
});

queryCurrentOsAccount(deprecated)

queryCurrentOsAccount(callback: AsyncCallback<OsAccountInfo>): void

查询当前进程所属的系统帐号的信息。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getCurrentOsAccount。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<OsAccountInfo>是回调函数。如果查询成功，err为null，data为当前进程所属的系统帐号信息；否则为错误对象。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.queryCurrentOsAccount((err: BusinessError, curAccountInfo: account_osAccount.OsAccountInfo)=>{
  console.log('queryCurrentOsAccount err:' + JSON.stringify(err));
  console.log('queryCurrentOsAccount curAccountInfo:' + JSON.stringify(curAccountInfo));
});

queryCurrentOsAccount(deprecated)

queryCurrentOsAccount(): Promise<OsAccountInfo>

查询当前进程所属的系统帐号的信息。使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getCurrentOsAccount。

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<OsAccountInfo>Promise对象，返回当前进程所属的系统帐号信息。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.queryCurrentOsAccount().then((accountInfo: account_osAccount.OsAccountInfo) => {
  console.log('queryCurrentOsAccount, accountInfo: ' + JSON.stringify(accountInfo));
}).catch((err: BusinessError) => {
  console.log('queryCurrentOsAccount err: ' + JSON.stringify(err));
});

getOsAccountTypeFromProcess(deprecated)

getOsAccountTypeFromProcess(callback: AsyncCallback<OsAccountType>): void

查询当前进程所属的系统帐号的帐号类型。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountType。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<OsAccountType>是回调函数。如果查询成功，err为null，data为当前进程所属的系统帐号的帐号类型；否则为错误对象。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountTypeFromProcess((err: BusinessError, accountType: account_osAccount.OsAccountType) => {
  console.log('getOsAccountTypeFromProcess err: ' + JSON.stringify(err));
  console.log('getOsAccountTypeFromProcess accountType: ' + accountType);
});

getOsAccountTypeFromProcess(deprecated)

getOsAccountTypeFromProcess(): Promise<OsAccountType>

查询当前进程所属的系统帐号的帐号类型。使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用getOsAccountType。

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<OsAccountType>Promise对象，返回当前进程所属的系统帐号的帐号类型。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountTypeFromProcess().then((accountType: account_osAccount.OsAccountType) => {
  console.log('getOsAccountTypeFromProcess, accountType: ' + accountType);
}).catch((err: BusinessError) => {
  console.log('getOsAccountTypeFromProcess err: ' + JSON.stringify(err));
});

getDistributedVirtualDeviceId(deprecated)

getDistributedVirtualDeviceId(callback: AsyncCallback<string>): void

获取分布式虚拟设备ID。使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用queryDistributedVirtualDeviceId。

需要权限： ohos.permission.DISTRIBUTED_DATASYNC 或 ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackAsyncCallback<string>是回调函数。如果获取成功，err为null，data为分布式虚拟设备ID；否则为错误对象。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.getDistributedVirtualDeviceId((err: BusinessError, virtualID: string) => {
  console.log('getDistributedVirtualDeviceId err: ' + JSON.stringify(err));
  console.log('getDistributedVirtualDeviceId virtualID: ' + virtualID);
});

getDistributedVirtualDeviceId(deprecated)

getDistributedVirtualDeviceId(): Promise<string>

获取分布式虚拟设备ID。使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃。建议使用queryDistributedVirtualDeviceId。

需要权限： ohos.permission.DISTRIBUTED_DATASYNC 或 ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
Promise<string>Promise对象，返回分布式虚拟设备ID。

示例：

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
accountManager.getDistributedVirtualDeviceId().then((virtualID: string) => {
  console.log('getDistributedVirtualDeviceId, virtualID: ' + virtualID);
}).catch((err: BusinessError) => {
  console.log('getDistributedVirtualDeviceId err: ' + JSON.stringify(err));
});

getOsAccountLocalIdBySerialNumber(deprecated)

getOsAccountLocalIdBySerialNumber(serialNumber: number, callback: AsyncCallback<number>): void

通过SN码查询与其关联的系统帐号的帐号ID。使用callback异步回调。

说明：

从 API version 8开始支持，从API version 9开始废弃。建议使用getOsAccountLocalIdForSerialNumber。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
serialNumbernumber是帐号SN码。
callbackAsyncCallback<number>是回调函数。如果查询成功，err为null，data为与SN码关联的系统帐号的帐号ID；否则为错误对象。

示例： 查询与SN码12345关联的系统帐号的ID

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let serialNumber: number = 12345;
accountManager.getOsAccountLocalIdBySerialNumber(serialNumber, (err: BusinessError, localId: number)=>{
  console.log('ger localId err:' + JSON.stringify(err));
  console.log('get localId:' + localId + ' by serialNumber: ' + serialNumber);
});

getOsAccountLocalIdBySerialNumber(deprecated)

getOsAccountLocalIdBySerialNumber(serialNumber: number): Promise<number>

通过SN码查询与其关联的系统帐号的帐号ID。使用Promise异步回调。

说明：

从 API version 8开始支持，从API version 9开始废弃。建议使用getOsAccountLocalIdForSerialNumber。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
serialNumbernumber是帐号SN码。

返回值：

类型说明
Promise<number>Promise对象，返回与SN码关联的系统帐号的帐号ID。

示例： 查询与SN码12345关联的系统帐号的ID

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let serialNumber: number = 12345;
accountManager.getOsAccountLocalIdBySerialNumber(serialNumber).then((localId: number) => {
  console.log('getOsAccountLocalIdBySerialNumber localId: ' + localId);
}).catch((err: BusinessError) => {
  console.log('getOsAccountLocalIdBySerialNumber err: ' + JSON.stringify(err));
});

getSerialNumberByOsAccountLocalId(deprecated)

getSerialNumberByOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void

通过系统帐号ID获取与该系统帐号关联的SN码。使用callback异步回调。

说明：

从 API version 8开始支持，从API version 9开始废弃。建议使用getSerialNumberForOsAccountLocalId。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。
callbackAsyncCallback<number>是回调函数。如果获取成功，err为null，data为与该系统帐号关联的SN码；否则为错误对象。

示例： 获取ID为100的系统帐号关联的SN码

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
accountManager.getSerialNumberByOsAccountLocalId(localId, (err: BusinessError, serialNumber: number)=>{
  console.log('ger serialNumber err:' + JSON.stringify(err));
  console.log('get serialNumber:' + serialNumber + ' by localId: ' + localId);
});

getSerialNumberByOsAccountLocalId(deprecated)

getSerialNumberByOsAccountLocalId(localId: number): Promise<number>

通过系统帐号ID获取与该系统帐号关联的SN码。使用Promise异步回调。

说明：

从 API version 8开始支持，从API version 9开始废弃。建议使用getSerialNumberForOsAccountLocalId。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
localIdnumber是系统帐号ID。

返回值：

类型说明
Promise<number>Promise对象，返回与该系统帐号关联的SN码。

示例： 获取ID为100的系统帐号关联的SN码

import { BusinessError } from '@ohos.base';
let accountManager = account_osAccount.getAccountManager();
let localId: number = 100;
accountManager.getSerialNumberByOsAccountLocalId(localId).then((serialNumber: number) => {
  console.log('getSerialNumberByOsAccountLocalId serialNumber: ' + serialNumber);
}).catch((err: BusinessError) => {
  console.log('getSerialNumberByOsAccountLocalId err: ' + JSON.stringify(err));
});

UserAuth8+

用户认证类。

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

constructor8+

constructor()

创建用户认证的实例。

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

系统能力：SystemCapability.Account.OsAccount

示例：

let userAuth = new account_osAccount.UserAuth();

getVersion8+

getVersion(): number;

返回版本信息。

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

系统能力： SystemCapability.Account.OsAccount

返回值：

类型说明
number返回版本信息。

示例：

let userAuth = new account_osAccount.UserAuth();
let version: number = userAuth.getVersion();
console.log('getVersion version = ' + version);

getAvailableStatus8+

getAvailableStatus(authType: AuthType, authTrustLevel: AuthTrustLevel): number;

获取指定认证类型和认证可信等级的认证能力的可用状态。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
authTypeAuthType是认证类型。
authTrustLevelAuthTrustLevel是认证的可信等级。

返回值：

类型说明
number返回认证能力的可用状态。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid authType or authTrustLevel.

示例：

let userAuth = new account_osAccount.UserAuth();
let authType: account_osAccount.AuthType = account_osAccount.AuthType.PIN;
let authTrustLevel: account_osAccount.AuthTrustLevel = account_osAccount.AuthTrustLevel.ATL1;
try {
  let status: number = userAuth.getAvailableStatus(authType, authTrustLevel);
  console.log('getAvailableStatus status = ' + status);
} catch (e) {
  console.log('getAvailableStatus exception = ' + JSON.stringify(e));
}

getProperty8+

getProperty(request: GetPropertyRequest, callback: AsyncCallback<ExecutorProperty>): void;

基于指定的请求信息获取属性。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
requestGetPropertyRequest是请求信息，包括认证类型和属性类型列表。
callbackAsyncCallback<ExecutorProperty>是回调函数。如果获取成功，err为null，data为执行器属性信息；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid request.

示例：

import { BusinessError } from '@ohos.base';
let userAuth = new account_osAccount.UserAuth();
let keys: Array<account_osAccount.GetPropertyType>  = [
  account_osAccount.GetPropertyType.AUTH_SUB_TYPE,
  account_osAccount.GetPropertyType.REMAIN_TIMES,
  account_osAccount.GetPropertyType.FREEZING_TIME
];
let request: account_osAccount.GetPropertyRequest = {
  authType: account_osAccount.AuthType.PIN,
  keys: keys
};
try {
  userAuth.getProperty(request, (err: BusinessError, result: account_osAccount.ExecutorProperty) => {
    console.log('getProperty err = ' + JSON.stringify(err));
    console.log('getProperty result = ' + JSON.stringify(result));
  });
} catch (e) {
  console.log('getProperty exception = ' + JSON.stringify(e));
}

getProperty8+

getProperty(request: GetPropertyRequest): Promise<ExecutorProperty>;

基于指定的请求信息获取属性。使用Promise异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
requestGetPropertyRequest是请求信息，包括认证类型和属性类型列表。

返回值：

类型说明
Promise<ExecutorProperty>Promise对象，返回执行者属性信息。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid request.

示例：

import { BusinessError } from '@ohos.base';
let userAuth = new account_osAccount.UserAuth();
let keys: Array<account_osAccount.GetPropertyType> = [
  account_osAccount.GetPropertyType.AUTH_SUB_TYPE, 
  account_osAccount.GetPropertyType.REMAIN_TIMES,
  account_osAccount.GetPropertyType.FREEZING_TIME
];
let request: account_osAccount.GetPropertyRequest = {
  authType: account_osAccount.AuthType.PIN,
  keys: keys
};
try {
  userAuth.getProperty(request).then((result: account_osAccount.ExecutorProperty) => {
    console.log('getProperty result = ' + JSON.stringify(result));
  }).catch((err: BusinessError) => {
    console.log('getProperty error = ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('getProperty exception = ' + JSON.stringify(e));
}

setProperty8+

setProperty(request: SetPropertyRequest, callback: AsyncCallback<void>): void;

设置可用于初始化算法的属性。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
requestSetPropertyRequest是请求信息，包括认证类型和要设置的密钥值。
callbackAsyncCallback<void>是回调函数。如果设置成功，err为null，否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid request.

示例：

import { BusinessError } from '@ohos.base';
let userAuth = new account_osAccount.UserAuth();
let request: account_osAccount.SetPropertyRequest = {
  authType: account_osAccount.AuthType.PIN,
  key: account_osAccount.SetPropertyType.INIT_ALGORITHM,
  setInfo: new Uint8Array([0])
};
try {
  userAuth.setProperty(request, (err: BusinessError) => {
    if (err) {
      console.log('setProperty failed, error = ' + JSON.stringify(err));
    } else {
      console.log('setProperty successfully');
    }
  });
} catch (e) {
  console.log('setProperty exception = ' + JSON.stringify(e));
}

setProperty8+

setProperty(request: SetPropertyRequest): Promise<void>;

设置可用于初始化算法的属性。使用Promise异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
requestSetPropertyRequest是请求信息，包括身份验证类型和要设置的密钥值。

返回值：

类型说明
Promise<void>Promise对象，无返回结果的Promise对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid request.

示例：

import { BusinessError } from '@ohos.base';
let userAuth = new account_osAccount.UserAuth();
let request: account_osAccount.SetPropertyRequest = {
  authType: account_osAccount.AuthType.PIN,
  key: account_osAccount.SetPropertyType.INIT_ALGORITHM,
  setInfo: new Uint8Array([0])
};
try {
  userAuth.setProperty(request).then(() => {
    console.log('setProperty successfully');
  }).catch((err: BusinessError) => {
    console.log('setProperty failed, error = ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('setProperty exception = ' + JSON.stringify(e));
}

auth8+

auth(challenge: Uint8Array, authType: AuthType, authTrustLevel: AuthTrustLevel, callback: IUserAuthCallback): Uint8Array;

认证当前用户。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
challengeUint8Array是指示挑战值，挑战值为一个随机数，用于提升安全性。
authTypeAuthType是指示认证类型。
authTrustLevelAuthTrustLevel是指示认证结果的信任级别。
callbackIUserAuthCallback是回调对象，返回认证结果。

返回值：

类型说明
Uint8Array返回取消的上下文ID。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid challenge, authType or authTrustLevel.
12300101Credential is incorrect.
12300102Credential not enrolled.
12300105Unsupported authTrustLevel.
12300106Unsupported authType.
12300109Authentication is canceled.
12300110Authentication is locked.
12300111Authentication timeout.
12300112Authentication service is busy.

示例：

let userAuth = new account_osAccount.UserAuth();
let challenge: Uint8Array = new Uint8Array([0]);
let authType: account_osAccount.AuthType = account_osAccount.AuthType.PIN;
let authTrustLevel: account_osAccount.AuthTrustLevel = account_osAccount.AuthTrustLevel.ATL1;
try {
  userAuth.auth(challenge, authType, authTrustLevel, {
    onResult: (result: number, extraInfo: account_osAccount.AuthResult) => {
        console.log('auth result = ' + result);
        console.log('auth extraInfo = ' + JSON.stringify(extraInfo));
    }
  });
} catch (e) {
  console.log('auth exception = ' + JSON.stringify(e));
}

authUser8+

authUser(userId: number, challenge: Uint8Array, authType: AuthType, authTrustLevel: AuthTrustLevel, callback: IUserAuthCallback): Uint8Array;

认证指定用户。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
userIdnumber是指示用户身份。
challengeUint8Array是指示挑战值，挑战值为一个随机数，用于提升安全性。
authTypeAuthType是指示认证类型。
authTrustLevelAuthTrustLevel是指示认证结果的信任级别。
callbackIUserAuthCallback是回调对象，返回认证结果。

返回值：

类型说明
Uint8Array返回取消的上下文ID。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid userId, challenge, authType or authTrustLevel.
12300101Credential is incorrect.
12300102Credential not enrolled.
12300105Unsupported authTrustLevel.
12300106Unsupported authType.
12300109Authentication is canceled.
12300110Authentication is locked.
12300111Authentication timeout.
12300112Authentication service is busy.

示例：

let userAuth = new account_osAccount.UserAuth();
let userID: number = 100;
let challenge: Uint8Array = new Uint8Array([0]);
let authType: account_osAccount.AuthType = account_osAccount.AuthType.PIN;
let authTrustLevel: account_osAccount.AuthTrustLevel = account_osAccount.AuthTrustLevel.ATL1;
try {
  userAuth.authUser(userID, challenge, authType, authTrustLevel, {
    onResult: (result,extraInfo) => {
      console.log('authUser result = ' + result);
      console.log('authUser extraInfo = ' + JSON.stringify(extraInfo));
    }
  });
} catch (e) {
  console.log('authUser exception = ' + JSON.stringify(e));
}

cancelAuth8+

cancelAuth(contextID: Uint8Array): void;

取消指定的认证操作。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
contextIdUint8Array是指示身份验证上下文ID，此ID动态生成没有具体值。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid contextId.

示例：

let userAuth = new account_osAccount.UserAuth();
let pinAuth: account_osAccount.PINAuth = new account_osAccount.PINAuth();
let challenge = new Uint8Array([0]);
let contextId: Uint8Array = userAuth.auth(challenge, account_osAccount.AuthType.PIN, account_osAccount.AuthTrustLevel.ATL1, {
  onResult: (result: number, extraInfo: account_osAccount.AuthResult) => {
    console.log('auth result = ' + result);
    console.log('auth extraInfo = ' + JSON.stringify(extraInfo));
  }
});
try {
  userAuth.cancelAuth(contextId);
} catch (e) {
  console.log('cancelAuth exception = ' + JSON.stringify(e));
}

PINAuth8+

PIN码认证基类。

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

constructor8+

constructor()

创建PIN码认证的实例。

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

系统能力：SystemCapability.Account.OsAccount

示例：

let pinAuth: account_osAccount.PINAuth = new account_osAccount.PINAuth();

registerInputer8+

registerInputer(inputer: IInputer): void;

注册PIN码输入器。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_PIN_AUTH

参数：

参数名类型必填说明
inputerIInputer是PIN码输入器，用于获取PIN码。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid inputer.
12300103Inputer already registered.

示例：

let pinAuth: account_osAccount.PINAuth = new account_osAccount.PINAuth();
let password = new Uint8Array([0, 0, 0, 0, 0]);
try {
  let result = pinAuth.registerInputer({
      onGetData: (authSubType: account_osAccount.AuthSubType, callback: account_osAccount.IInputData) => {
        callback.onSetData(authSubType, password);
      }
  });
  console.log('registerInputer result = ' + result);
} catch (e) {
  console.log('registerInputer exception = ' + JSON.stringify(e));
}

unregisterInputer8+

unregisterInputer(): void;

解注册PIN码输入器。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_PIN_AUTH

示例：

let pinAuth: account_osAccount.PINAuth = new account_osAccount.PINAuth();
pinAuth.unregisterInputer();

InputerManager 9+

凭据输入管理器。

registerInputer9+

static registerInputer(authType: AuthType, inputer: IInputer): void

注册凭据输入器。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL 或 ohos.permission.MANAGE_USER_IDM

参数：

参数名类型必填说明
authTypeAuthType是认证类型。
inputerIInputer是凭据输入器，用于获取凭据。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid authType or inputer.
12300103The credential inputer has been registered.
12300106Unsupported authType.

示例：

let authType: account_osAccount.AuthType = account_osAccount.AuthType.DOMAIN;
let password: Uint8Array = new Uint8Array([0, 0, 0, 0, 0]);
try {
  account_osAccount.InputerManager.registerInputer(authType, {
      onGetData: (authSubType: account_osAccount.AuthSubType, callback: account_osAccount.IInputData) => {
        callback.onSetData(authSubType, password);
      }
  });
  console.log('registerInputer success.');
} catch (e) {
  console.log('registerInputer exception = ' + JSON.stringify(e));
}

unregisterInputer9+

static unregisterInputer(authType: AuthType): void

解注册凭据输入器。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL 或 ohos.permission.MANAGE_USER_IDM

参数：

参数名类型必填说明
authTypeAuthType是认证类型。

错误码：

错误码ID错误信息
12300002Invalid authType.

示例：

let authType: account_osAccount.AuthType = account_osAccount.AuthType.DOMAIN;
try {
  account_osAccount.InputerManager.unregisterInputer(authType);
  console.log('unregisterInputer success.');
} catch(err) {
  console.log('unregisterInputer err:' + JSON.stringify(err));
}

DomainPlugin9+

域插件，提供域帐号认证功能。

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

auth9+

auth(domainAccountInfo: DomainAccountInfo, credential: Uint8Array, callback: IUserAuthCallback): void

认证指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
credentialUint8Array是指示域帐号的凭据。
callbackIUserAuthCallback是指示认证结果回调。

示例：

import { AsyncCallback } from './@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {
    // mock authentication
    // notify authentication result
    let result: account_osAccount.AuthResult = {
      token: new Uint8Array([0]),
      remainTimes: 5,
      freezingTime: 0
    };
    callback.onResult(0, result);
  },
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {},
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                    callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
account_osAccount.DomainAccountManager.registerPlugin(plugin);
let userAuth = new account_osAccount.UserAuth();
let challenge: Uint8Array = new Uint8Array([0]);
let authType: account_osAccount.AuthType = account_osAccount.AuthType.DOMAIN;
let authTrustLevel: account_osAccount.AuthTrustLevel = account_osAccount.AuthTrustLevel.ATL1;
try {
  userAuth.auth(challenge, authType, authTrustLevel, {
    onResult: (resultCode: number, authResult: account_osAccount.AuthResult) => {
        console.log('auth resultCode = ' + resultCode);
        console.log('auth authResult = ' + JSON.stringify(authResult));
    }
  });
} catch (err) {
  console.log('auth exception = ' + JSON.stringify(err));
}

authWithPopup10+

authWithPopup(domainAccountInfo: DomainAccountInfo, callback: IUserAuthCallback): void

弹窗认证指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
callbackIUserAuthCallback是指示认证结果回调。

示例：

import { AsyncCallback } from './@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {
    // mock authentication
    // notify authentication result
    let result: account_osAccount.AuthResult = {
      token: new Uint8Array([0]),
      remainTimes: 5,
      freezingTime: 0
    };
    callback.onResult(0, result);
  },
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {},
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
account_osAccount.DomainAccountManager.registerPlugin(plugin)

authWithToken10+

authWithToken(domainAccountInfo: DomainAccountInfo, token: Uint8Array, callback: IUserAuthCallback): void

使用授权令牌认证指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
tokenUint8Array是指示PIN码或生物识别认证成功时生成的授权令牌。
callbackIUserAuthCallback是指示认证结果回调。

示例：

import { AsyncCallback } from './@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {
    // mock authentication
    // notify authentication result
    let result: account_osAccount.AuthResult = {
      token: new Uint8Array([0]),
      remainTimes: 5,
      freezingTime: 0
    };
    callback.onResult(0, result);
  },
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {},
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
account_osAccount.DomainAccountManager.registerPlugin(plugin)

getAccountInfo10+

getAccountInfo(options: GetDomainAccountInfoPluginOptions, callback: AsyncCallback<DomainAccountInfo>): void

查询指定域帐号的信息。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
optionsGetDomainAccountInfoPluginOptions是指示域帐号信息。
callbackAsyncCallback<DomainAccountInfo>是指示查询结果回调。

示例：

import { AsyncCallback, BusinessError } from '@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {
    // mock getting account information
    // notify result
    let code: BusinessError = {
      code: 0,
      name: "",
      message: ""
    };
    let accountInfo: account_osAccount.DomainAccountInfo = {
      domain: options.domain,
      accountName: options.accountName,
      accountId: 'xxxx'
    };
    callback(code, accountInfo);
  },
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
account_osAccount.DomainAccountManager.registerPlugin(plugin)

getAuthStatusInfo10+

getAuthStatusInfo(domainAccountInfo: DomainAccountInfo, callback: AsyncCallback<AuthStatusInfo>): void

查询指定域帐号的认证状态信息。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
callbackAsyncCallback<AuthStatusInfo>是指示查询结果回调。

示例：

import { AsyncCallback, BusinessError } from '@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {},
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {
    let code: BusinessError = {
      code: 0,
      name: "",
      message: ""
    };
    let statusInfo: account_osAccount.AuthStatusInfo = {
      remainTimes: 5,
      freezingTime: 0
    };
    callback(code, statusInfo);
  },
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
account_osAccount.DomainAccountManager.registerPlugin(plugin)

bindAccount10+

bindAccount(domainAccountInfo: DomainAccountInfo, localId: number, callback: AsyncCallback<void>): void

绑定指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
callbackAsyncCallback<void>是指示绑定结果回调。

示例：

import { AsyncCallback, BusinessError } from './@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {},
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {
    // mock unbinding operation
    // notify binding result
    let code: BusinessError = {
      code: 0,
      name: "",
      message: ""
    };
    callback(code);
  },
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
account_osAccount.DomainAccountManager.registerPlugin(plugin)

unbindAccount10+

unbindAccount(domainAccountInfo: DomainAccountInfo, callback: AsyncCallback<void>): void

解绑指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
callbackAsyncCallback<void>是指示绑定结果回调。

示例：

import { AsyncCallback, BusinessError } from './@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {},
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {
    // mock unbinding operation
    // notify unbinding result
    let code: BusinessError = {
      code: 0,
      name: "",
      message: ""
    };
    callback(code);
  },
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
account_osAccount.DomainAccountManager.registerPlugin(plugin)

isAccountTokenValid10+

isAccountTokenValid(domainAccountInfo: DomainAccountInfo, token: Uint8Array, callback: AsyncCallback<boolean>): void

检查指定的域帐号令牌是否有效。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
tokenUint8Array是指示域帐号令牌。
callbackAsyncCallback<boolean>是指示检查结果回调。

示例：

import { AsyncCallback, BusinessError } from './@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {},
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {
    // mock checking operation
    // notify checking result
    let code: BusinessError = {
      code: 0,
      name: "",
      message: ""
    };
    callback(code, true);
  },
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
account_osAccount.DomainAccountManager.registerPlugin(plugin)

getAccessToken10+

getAccessToken(options: GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>): void

根据指定的选项获取域访问令牌。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
optionsGetDomainAccessTokenOptions是指示获取域访问令牌的选项。
callbackAsyncCallback<Uint8Array>是指示结果回调。

示例：

import { AsyncCallback, BusinessError } from './@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {},
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {
    // mock getting operation
    // notify result
    let code: BusinessError = {
      code: 0,
      name: "",
      message: ""
    };
    let token: Uint8Array = new Uint8Array([0]);
    callback(code, token);
  }
}
account_osAccount.DomainAccountManager.registerPlugin(plugin)

DomainAccountManager 9+

域帐号管理器类。

registerPlugin9+

static registerPlugin(plugin: DomainPlugin): void

注册域插件。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

参数：

参数名类型必填说明
pluginDomainPlugin是指示域插件。

错误码：

错误码ID错误信息
12300201The domain plugin has been registered.

示例：

import { AsyncCallback } from './@ohos.base';
let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
       callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions,
                 callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {},
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                      callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
try {
  account_osAccount.DomainAccountManager.registerPlugin(plugin);
  console.log('registerPlugin success.');
} catch(err) {
  console.log('registerPlugin err:' + JSON.stringify(err));
}

unregisterPlugin9+

static unregisterPlugin(): void

注销域插件。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

示例：

try {
  account_osAccount.DomainAccountManager.unregisterPlugin();
  console.log('unregisterPlugin success.');
} catch(err) {
  console.log('unregisterPlugin err:' + JSON.stringify(err));
}

auth10+

auth(domainAccountInfo: DomainAccountInfo, credential: Uint8Array, callback: IUserAuthCallback): void

认证指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
credentialUint8Array是指示域帐号的凭据。
callbackIUserAuthCallback是指示认证结果回调。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid domainAccountInfo or credential.
12300003Domain account does not exist.
12300013Network exception.
12300101Authentication failed.
12300109Authentication is canceled.
12300110Authentication is locked.
12300111Authentication timeout.
12300112Authentication service is busy.
12300113Authentication service does not exist.
12300114Authentication service exception.

示例：

let domainAccountInfo: account_osAccount.DomainAccountInfo = {
  domain: 'CHINA',
  accountName: 'zhangsan'
}
let credential = new Uint8Array([0])
try {
  account_osAccount.DomainAccountManager.auth(domainAccountInfo, credential, {
    onResult: (resultCode: number, authResult: account_osAccount.AuthResult) => {
      console.log('auth resultCode = ' + resultCode);
      console.log('auth authResult = ' + JSON.stringify(authResult));
    }
  });
} catch (err) {
  console.log('auth exception = ' + JSON.stringify(err));
}

authWithPopup10+

authWithPopup(callback: IUserAuthCallback): void

弹框认证指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
callbackIUserAuthCallback是指示认证结果回调。

错误码：

错误码ID错误信息
12300001System service exception.
12300003No domain account is bound.
12300013Network exception.
12300101Authentication failed.
12300109Authentication is canceled.
12300110Authentication is locked.
12300111Authentication timeout.
12300112Authentication service is busy.
12300113Authentication service does not exist.
12300114Authentication service exception.

示例：

try {
  account_osAccount.DomainAccountManager.authWithPopup({
    onResult: (resultCode: number, authResult: account_osAccount.AuthResult) => {
      console.log('auth resultCode = ' + resultCode);
      console.log('auth authResult = ' + JSON.stringify(authResult));
    }
  })
} catch (err) {
  console.log('auth exception = ' + JSON.stringify(err));
}

authWithPopup10+

authWithPopup(localId: number, callback: IUserAuthCallback): void

弹框认证指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.ACCESS_USER_AUTH_INTERNAL

参数：

参数名类型必填说明
localIdnumber是指示绑定域帐号的系统帐号的本地标识。
callbackIUserAuthCallback是指示认证结果回调。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid localId.
12300003No domain account is bound.
12300013Network exception.
12300101Authentication failed.
12300109Authentication is canceled.
12300110Authentication is locked.
12300111Authentication timeout.
12300112Authentication service is busy.
12300113Authentication service does not exist.
12300114Authentication service exception.

示例：

try {
  account_osAccount.DomainAccountManager.authWithPopup(100, {
    onResult: (resultCode: number, authResult: account_osAccount.AuthResult) => {
      console.log('authWithPopup resultCode = ' + resultCode);
      console.log('authWithPopup authResult = ' + JSON.stringify(authResult));
    }
  })
} catch (err) {
  console.log('authWithPopup exception = ' + JSON.stringify(err));
}

hasAccount10+

hasAccount(domainAccountInfo: DomainAccountInfo, callback: AsyncCallback<boolean>): void

检查是否存在指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
callbackAsyncCallback<boolean>是指示检查结果回调。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid domainAccountInfo.
12300013Network exception.
12300111Operation timeout.

示例：

import { BusinessError } from '@ohos.base';
let domainAccountInfo: account_osAccount.DomainAccountInfo = {
  domain: 'CHINA',
  accountName: 'zhangsan'
}
try {
  account_osAccount.DomainAccountManager.hasAccount(domainAccountInfo, (err: BusinessError, result: boolean) => {
    if (err) {
      console.log('call hasAccount failed, error: ' + JSON.stringify(err));
    } else {
      console.log('hasAccount result: ' + result);
    }
  });
} catch (err) {
  console.log('hasAccount exception = ' + JSON.stringify(err));
}

hasAccount10+

hasAccount(domainAccountInfo: DomainAccountInfo): Promise<boolean>

检查是否存在指定的域帐号。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。

返回值：

类型说明
Promise<boolean>Promise对象，返回指定的域帐号是否存在。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid domainAccountInfo.
12300013Network exception.
12300111Operation timeout.

示例：

import { BusinessError } from '@ohos.base';
let domainAccountInfo: account_osAccount.DomainAccountInfo = {
  domain: 'CHINA',
  accountName: 'zhangsan'
}
try {
  account_osAccount.DomainAccountManager.hasAccount(domainAccountInfo).then((result: boolean) => {
    console.log('hasAccount result: ' + result);
  }).catch((err: BusinessError) => {
      console.log('call hasAccount failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('hasAccount exception = ' + JSON.stringify(err));
}

updateAccountToken10+

updateAccountToken(domainAccountInfo: DomainAccountInfo, token: Uint8Array, callback: AsyncCallback<void>): void;

更新指定域帐号的令牌，空令牌表示目标域帐号的令牌失效。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
tokenUint8Array是指示域帐号的令牌。
callbackAsyncCallback<void>是回调函数。如果更新成功，err为null，否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid token.
12300003Account not found.

示例：

import { BusinessError } from '@ohos.base';
let domainAccountInfo: account_osAccount.DomainAccountInfo = {
  domain: 'CHINA',
  accountName: 'zhangsan',
  accountId: '123456'
}
let token = new Uint8Array([0])
try {
  account_osAccount.DomainAccountManager.updateAccountToken(domainAccountInfo, token, (err: BusinessError) => {
    if (err != null) {
      console.log('updateAccountToken failed, error: ' + JSON.stringify(err));
    } else {
      console.log('updateAccountToken successfully');
    }
  })
} catch (err) {
  console.log('updateAccountToken exception = ' + JSON.stringify(err));
}

updateAccountToken10+

updateAccountToken(domainAccountInfo: DomainAccountInfo, token: Uint8Array): Promise<void>

更新指定域帐号的令牌，空令牌表示目标域帐号的令牌失效。使用Promise异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

参数：

参数名类型必填说明
domainAccountInfoDomainAccountInfo是指示域帐号信息。
tokenUint8Array是指示域帐号的令牌。

返回值：

类型说明
Promise<void>Promise对象，无返回结果的Promise对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid token.
12300003Account not found.

示例：

import { BusinessError } from '@ohos.base';
let domainAccountInfo: account_osAccount.DomainAccountInfo = {
  domain: 'CHINA',
  accountName: 'zhangsan',
  accountId: '123456'
}
let token = new Uint8Array([0])
try {
  account_osAccount.DomainAccountManager.updateAccountToken(domainAccountInfo, token).then(() => {
    console.log('updateAccountToken successfully');
  }).catch((err: BusinessError) => {
      console.log('updateAccountToken failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('updateAccountToken exception = ' + JSON.stringify(err));
}

getAccountInfo10+

getAccountInfo(options: GetDomainAccountInfoOptions, callback: AsyncCallback<DomainAccountInfo>): void

查询指定的域帐号信息，callback方式。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.GET_DOMAIN_ACCOUNTS

参数：

参数名类型必填说明
optionsGetDomainAccountInfoOptions是指示域帐号信息。
callbackAsyncCallback<DomainAccountInfo>是指示查询结果回调。

错误码：

错误码ID错误信息
12300001System service exception.
12300003Account not found.
12300013Network exception.
12300111Operation timeout.

示例：

import { BusinessError } from '@ohos.base';
let domainAccountInfo: account_osAccount.GetDomainAccountInfoOptions = {
  domain: 'CHINA',
  accountName: 'zhangsan'
}
try {
  account_osAccount.DomainAccountManager.getAccountInfo(domainAccountInfo,
    (err: BusinessError, result: account_osAccount.DomainAccountInfo) => {
    if (err) {
      console.log('call getAccountInfo failed, error: ' + JSON.stringify(err));
    } else {
      console.log('getAccountInfo result: ' + result);
    }
  });
} catch (err) {
  console.log('getAccountInfo exception = ' + JSON.stringify(err));
}

getAccountInfo10+

getAccountInfo(options: GetDomainAccountInfoOptions): Promise<DomainAccountInfo>

查询指定的域帐号信息，promise方式。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.GET_DOMAIN_ACCOUNTS

参数：

参数名类型必填说明
optionsGetDomainAccountInfoOptions是指示域帐号信息。

返回值：

类型说明
Promise<DomainAccountInfo>Promise对象，返回指定的域帐号信息。

错误码：

错误码ID错误信息
12300001System service exception.
12300003Account not found.
12300013Network exception.
12300111Operation timeout.

示例：

import { BusinessError } from '@ohos.base';
let domainAccountInfo: account_osAccount.GetDomainAccountInfoOptions = {
  domain: 'CHINA',
  accountName: 'zhangsan'
}
try {
  account_osAccount.DomainAccountManager.getAccountInfo(domainAccountInfo)
    .then((result: account_osAccount.DomainAccountInfo) => {
    console.log('getAccountInfo result: ' + result);
  }).catch((err: BusinessError) => {
    console.log('call getAccountInfo failed, error: ' + JSON.stringify(err));
  });
} catch (err) {
  console.log('getAccountInfo exception = ' + JSON.stringify(err));
}

UserIdentityManager8+

获取用户身份管理类。

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

constructor8+

constructor()

用户身份管理类的默认构造函数。

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

系统能力：SystemCapability.Account.OsAccount

示例：

let userIDM = new account_osAccount.UserIdentityManager();

openSession8+

openSession(callback: AsyncCallback<Uint8Array>): void;

打开会话，获取挑战值。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_USER_IDM

参数：

参数名类型必填说明
callbackAsyncCallback<Uint8Array>是回调函数。如果打开会话成功，err为null，data为挑战值；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let userIDM = new account_osAccount.UserIdentityManager();
try {
  userIDM.openSession((err: BusinessError, challenge: Uint8Array) => {
      console.log('openSession error = ' + JSON.stringify(err));
      console.log('openSession challenge = ' + JSON.stringify(challenge));
  });
} catch (e) {
  console.log('openSession exception = ' + JSON.stringify(e));
}

openSession8+

openSession(): Promise<Uint8Array>;

打开会话，获取挑战值。使用Promise异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_USER_IDM

返回值：

类型说明
Promise<Uint8Array>Promise对象，返回挑战值。

错误码：

错误码ID错误信息
12300001System service exception.

示例：

import { BusinessError } from '@ohos.base';
let userIDM = new account_osAccount.UserIdentityManager();
try {
  userIDM.openSession().then((challenge: Uint8Array) => {
      console.info('openSession challenge = ' + JSON.stringify(challenge));
  }).catch((err: BusinessError) => {
      console.info('openSession error = ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('openSession exception = ' + JSON.stringify(e));
}

addCredential8+

addCredential(credentialInfo: CredentialInfo, callback: IIdmCallback): void;

添加凭据，添加用户凭据信息，传入凭据添加方法和凭据信息（凭据类型，子类，如果添加用户的非密码凭据，则传入密码身份验证令牌），并获取结果/获取信息。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_USER_IDM

参数：

参数名类型必填说明
credentialInfoCredentialInfo是指示凭据信息。
callbackIIdmCallback是回调对象，返回添加凭据的结果。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid credentialInfo, i.e. authType or authSubType.
12300101Token is invalid.
12300106Unsupported authType.
12300109Operation is canceled.
12300111Operation timeout.
12300115The number of credentials reaches the upper limit.

示例：

import { BusinessError } from '@ohos.base';
let password: Uint8Array = new Uint8Array([0, 0, 0, 0, 0, 0]);
let pinAuth: account_osAccount.PINAuth = new account_osAccount.PINAuth();
pinAuth.registerInputer({
  onGetData: (authSubType: account_osAccount.AuthSubType, callback: account_osAccount.IInputData) => {
    callback.onSetData(authSubType, password);
  }
});
let credentialInfo: account_osAccount.CredentialInfo = {
  credType: account_osAccount.AuthType.PIN,
  credSubType: account_osAccount.AuthSubType.PIN_SIX,
  token: new Uint8Array([]),
};
let userIDM = new account_osAccount.UserIdentityManager();
userIDM.openSession((err: BusinessError, challenge: Uint8Array) => {
  try {
  userIDM.addCredential(credentialInfo, {
    onResult: (result: number, extraInfo: account_osAccount.RequestResult) => {
      console.log('addCredential result = ' + result);
      console.log('addCredential extraInfo = ' + extraInfo);
    }
  });
  } catch (e) {
    console.log('addCredential exception = ' + JSON.stringify(e));
  }
});

updateCredential8+

updateCredential(credentialInfo: CredentialInfo, callback: IIdmCallback): void;

更新凭据。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_USER_IDM

参数：

参数名类型必填说明
credentialInfoCredentialInfo是指示凭据信息。
callbackIIdmCallback是回调对象，返回更新凭据的结果。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid credentialInfo, i.e. authType or authSubType or token.
12300101Token is invalid.
12300102Credential not enrolled.
12300106Unsupported authType.
12300109Operation is canceled.
12300111Operation timeout.

示例：

import { BusinessError } from '@ohos.base';
let userIDM = new account_osAccount.UserIdentityManager();
let userAuth: account_osAccount.UserAuth = new account_osAccount.UserAuth();
let pinAuth: account_osAccount.PINAuth = new account_osAccount.PINAuth();
let password: Uint8Array = new Uint8Array([0, 0, 0, 0, 0, 0]);
let credentialInfo: account_osAccount.CredentialInfo = {
  credType: account_osAccount.AuthType.PIN,
  credSubType: account_osAccount.AuthSubType.PIN_SIX,
  token: new Uint8Array([]),
};
pinAuth.registerInputer({
  onGetData: (authSubType: account_osAccount.AuthSubType, callback: account_osAccount.IInputData) => {
    callback.onSetData(authSubType, password);
  }
});
userIDM.openSession((err: BusinessError, challenge: Uint8Array) => {
  userAuth.auth(challenge, credentialInfo.credType, account_osAccount.AuthTrustLevel.ATL1, {
    onResult: (result: number, extraInfo: account_osAccount.AuthResult) => {
      if (result != account_osAccount.ResultCode.SUCCESS) {
        return;
      }
      if (extraInfo.token != null) {
        credentialInfo.token = extraInfo.token;
      }
      try {
        userIDM.updateCredential(credentialInfo, {
          onResult: (result: number, extraInfo: account_osAccount.RequestResult) => {
              console.log('updateCredential result = ' + result);
              console.log('updateCredential extraInfo = ' + extraInfo);
          }
        });
      } catch (e) {
        console.log('updateCredential exception = ' + JSON.stringify(e));
      }
    }
  });
});

closeSession8+

closeSession(): void;

关闭会话，结束IDM操作。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_USER_IDM

示例：

let userIDM = new account_osAccount.UserIdentityManager();
userIDM.closeSession();

cancel8+

cancel(challenge: Uint8Array): void;

根据挑战值取消条目。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_USER_IDM

参数：

参数名类型必填说明
challengeUint8Array是挑战值。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid challenge.

示例：

let userIDM = new account_osAccount.UserIdentityManager();
let challenge: Uint8Array = new Uint8Array([0]);
try {
  userIDM.cancel(challenge);
} catch(err) {
  console.log('cancel err:' + JSON.stringify(err));
}

delUser8+

delUser(token: Uint8Array, callback: IIdmCallback): void;

删除具有身份验证令牌的用户，使用callback方式异步返回结果。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_USER_IDM

参数：

参数名类型必填说明
tokenUint8Array是身份验证令牌。
callbackIIdmCallback是回调对象，返回删除用户的结果。

错误码：

错误码ID错误信息
12300001System service exception.
12300101Token is invalid.

示例：

let userIDM = new account_osAccount.UserIdentityManager();
let token: Uint8Array = new Uint8Array([0]);
try {
  userIDM.delUser(token, {
    onResult: (result: number, extraInfo: account_osAccount.RequestResult) => {
      console.log('delUser result = ' + result);
      console.log('delUser extraInfo = ' + JSON.stringify(extraInfo));
    }
  });
} catch (e) {
  console.log('delUser exception = ' + JSON.stringify(e));
}

delCred8+

delCred(credentialId: Uint8Array, token: Uint8Array, callback: IIdmCallback): void;

删除用户凭据信息。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.MANAGE_USER_IDM

参数：

参数名类型必填说明
credentialIdUint8Array是凭证索引。
tokenUint8Array是身份验证令牌。
callbackIIdmCallback是回调对象，返回删除凭据的结果。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid credentialId.
12300101Token is invalid.
12300102Credential not enrolled.

示例：

let userIDM = new account_osAccount.UserIdentityManager();
let credentialId: Uint8Array = new Uint8Array([0, 0, 0, 0, 0, 0, 0, 0]);
let token: Uint8Array = new Uint8Array([0]);
try {
  userIDM.delCred(credentialId, token, {
    onResult: (result: number, extraInfo: account_osAccount.RequestResult) => {
        console.log('delCred result = ' + result);
        console.log('delCred extraInfo = ' + JSON.stringify(extraInfo));
    }
  });
} catch (e) {
  console.log('delCred exception = ' + JSON.stringify(e));
}

getAuthInfo8+

getAuthInfo(callback: AsyncCallback<Array<EnrolledCredInfo>>): void;

获取认证信息。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.USE_USER_IDM

参数：

参数名类型必填说明
callbackAsyncCallback<Array<EnrolledCredInfo>>是回调函数。如果成功，err为null，data为当前用户的所有已注册凭据信息；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300102Credential not enrolled.

示例：

import { BusinessError } from '@ohos.base';
let userIDM = new account_osAccount.UserIdentityManager();
try {
  userIDM.getAuthInfo((err: BusinessError, result: account_osAccount.EnrolledCredInfo[]) => {
    console.log('getAuthInfo err = ' + JSON.stringify(err));
    console.log('getAuthInfo result = ' + JSON.stringify(result));
  });
} catch (e) {
  console.log('getAuthInfo exception = ' + JSON.stringify(e));
}

getAuthInfo8+

getAuthInfo(authType: AuthType, callback: AsyncCallback<Array<EnrolledCredInfo>>): void;

获取指定类型的认证信息。使用callback异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.USE_USER_IDM

参数：

参数名类型必填说明
authTypeAuthType是认证类型。
callbackAsyncCallback<Array<EnrolledCredInfo>>是回调函数，如果获取成功，err为null，data为当前用户指定类型的所有已注册凭据信息；否则为错误对象。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid authType.
12300102Credential not enrolled.

示例：

import { BusinessError } from '@ohos.base';
let userIDM = new account_osAccount.UserIdentityManager();
try {
  userIDM.getAuthInfo(account_osAccount.AuthType.PIN,
    (err: BusinessError, result: account_osAccount.EnrolledCredInfo[]) => {
    console.log('getAuthInfo err = ' + JSON.stringify(err));
    console.log('getAuthInfo result = ' + JSON.stringify(result));
  });
} catch (e) {
  console.log('getAuthInfo exception = ' + JSON.stringify(e));
}

getAuthInfo8+

getAuthInfo(authType?: AuthType): Promise<Array<EnrolledCredInfo>>;

获取认证信息。使用Promise异步回调。

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

系统能力： SystemCapability.Account.OsAccount

需要权限： ohos.permission.USE_USER_IDM

参数：

参数名类型必填说明
authTypeAuthType否认证类型，默认为空，表示查询所有认证类型的信息。

返回值：

类型说明
Promise<Array<EnrolledCredInfo>>Promise对象，返回当前用户指定类型的所有已注册凭据信息。

错误码：

错误码ID错误信息
12300001System service exception.
12300002Invalid authType.
12300102Credential not enrolled.

示例：

import { BusinessError } from '@ohos.base';
let userIDM = new account_osAccount.UserIdentityManager();
try {
  userIDM.getAuthInfo(account_osAccount.AuthType.PIN).then((result: account_osAccount.EnrolledCredInfo[]) => {
    console.log('getAuthInfo result = ' + JSON.stringify(result))
  }).catch((err: BusinessError) => {
    console.log('getAuthInfo error = ' + JSON.stringify(err));
  });
} catch (e) {
  console.log('getAuthInfo exception = ' + JSON.stringify(e));
}

IInputData8+

密码数据回调。

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

onSetData8+

onSetData: (authSubType: AuthSubType, data: Uint8Array) => void;

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

通知设置数据。

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
authSubTypeAuthSubType是用于认证的凭据子类型。
dataUint8Array是要设置的数据是凭据，用来在认证、添加、修改凭据操作。

错误码：

错误码ID错误信息
12300002Invalid pinSubType.

示例：

let password: Uint8Array = new Uint8Array([0, 0, 0, 0, 0, 0]);
let passwordNumber: Uint8Array = new Uint8Array([1, 2, 3, 4]);
let inputer: account_osAccount.IInputer = {
  onGetData: (authSubType: account_osAccount.AuthSubType, callback: account_osAccount.IInputData) => {
      if (authSubType == account_osAccount.AuthSubType.PIN_NUMBER) {
        callback.onSetData(authSubType, passwordNumber);
      } else {
        callback.onSetData(authSubType, password);
      }
  }
};

IInputer8+

凭据输入器回调。

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

onGetData8+

onGetData: (authSubType: AuthSubType, callback: IInputData) => void;

通知获取数据。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
callbackIInputData是指示密码数据回调。

示例：

let password: Uint8Array = new Uint8Array([0, 0, 0, 0, 0, 0]);
let passwordNumber: Uint8Array = new Uint8Array([1, 2, 3, 4]);
let inputer: account_osAccount.IInputer = {
  onGetData: (authSubType: account_osAccount.AuthSubType, callback: account_osAccount.IInputData) => {
      if (authSubType == account_osAccount.AuthSubType.PIN_NUMBER) {
        callback.onSetData(authSubType, passwordNumber);
      } else {
        callback.onSetData(authSubType, password);
      }
  }
};
let pinAuth: account_osAccount.PINAuth = new account_osAccount.PINAuth();
let result = pinAuth.registerInputer(inputer);
console.log('registerInputer result: ' + result);

IUserAuthCallback8+

表示用户认证回调类。

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

onResult8+

onResult: (result: number, extraInfo: AuthResult) => void;

身份认证结果回调函数，返回结果码和认证结果信息。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
resultnumber是表示身份认证结果代码。
extraInfoAuthResult是表示不同情况下的具体信息，如果认证通过，则在extrainfo中返回认证令牌，如果身份验证失败，则在extrainfo中返回剩余的身份验证时间，如果身份验证执行器被锁定，冻结时间将在extrainfo中返回。

示例：

let authCallback: account_osAccount.IUserAuthCallback = {
  onResult: (result: number, extraInfo: account_osAccount.AuthResult) => {
    console.log('auth result = ' + result);
    console.log('auth extraInfo = ' + JSON.stringify(extraInfo));
  }
};

onAcquireInfo?8+

onAcquireInfo?: (module: number, acquire: number, extraInfo: any) => void;

身份认证信息获取回调函数。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
modulenumber是指示用于身份验证的执行器类型。
acquirenumber是指示不同身份验证执行器的tip代码。
extraInfoany是保留参数。

示例：

let authCallback: account_osAccount.IUserAuthCallback = {
  onResult: (result: number, extraInfo: account_osAccount.AuthResult) => {
    console.log('auth result = ' + result)
    console.log('auth extraInfo = ' + JSON.stringify(extraInfo));
  },
  onAcquireInfo: (module: number, acquire: number, extraInfo: account_osAccount.RequestResult) => {
    console.log('auth module = ' + module);
    console.log('auth acquire = ' + acquire);
    console.info('auth extraInfo = ' + JSON.stringify(extraInfo));
  }
};

IIdmCallback8+

表示身份管理回调类。

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

onResult8+

onResult: (result: number, extraInfo: RequestResult) => void;

身份管理操作结果回调函数，返回结果码和请求结果信息。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
resultnumber是表示身份认证结果代码。
extraInfoRequestResult是针对不同情况传递具体信息。

示例：

let idmCallback: account_osAccount.IIdmCallback = {
  onResult: (result: number, extraInfo: account_osAccount.RequestResult) => {
    console.log('callback result = ' + result)
    console.info('callback extraInfo = ' + JSON.stringify(extraInfo));
  }
};

onAcquireInfo?8+

onAcquireInfo?: (module: number, acquire: number, extraInfo: any) => void;

身份管理信息获取回调函数。

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

系统能力： SystemCapability.Account.OsAccount

参数：

参数名类型必填说明
modulenumber是指示用于身份验证的执行器类型。
acquirenumber是指示不同身份验证执行器的tip代码。
extraInfoany是保留参数。

示例：

let idmCallback: account_osAccount.IIdmCallback = {
  onResult: (result: number, extraInfo: Object) => {
    console.log('callback result = ' + result)
    console.log('callback onResult = ' + JSON.stringify(extraInfo));
  },
  onAcquireInfo: (module: number, acquire: number, extraInfo: Object) => {
    console.log('callback module = ' + module);
    console.log('callback acquire = ' + acquire);
    console.log('callback onacquireinfo = ' + JSON.stringify(extraInfo));
  }
};

GetPropertyRequest8+

提供获取属性请求的信息。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称类型必填说明
authTypeAuthType是身份验证凭据类型。
keysArray<GetPropertyType>是指示要获取的属性类型数组。

SetPropertyRequest8+

提供设置属性请求的信息。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称类型必填说明
authTypeAuthType是身份验证凭据类型。
keySetPropertyType是指示要设置的属性类型。
setInfoUint8Array是指示要设置的信息。

ExecutorProperty8+

提供执行器的属性。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称类型可读可写说明
resultnumber是是指示结果。
authSubTypeAuthSubType是是指示认证凭据子类型。
remainTimesnumber是是指示剩余次数。
freezingTimenumber是是指示冻结时间。
enrollmentProgress10+string是是指示录入进度，默认为空。
sensorInfo10+string是是指示传感器信息，默认为空。

AuthResult8+

表示认证结果的信息。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称类型必填说明
tokenUint8Array否指示认证令牌，默认为空。
remainTimesnumber否指示剩余次数，默认为空。
freezingTimenumber否指示冻结时间，默认为空。

CredentialInfo8+

表示凭证信息。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称类型必填说明
credTypeAuthType是指示凭据类型。
credSubTypeAuthSubType是指示凭据子类型。
tokenUint8Array是指示认证令牌。

RequestResult8+

表示请求结果的信息。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称类型必填说明
credentialIdUint8Array否指示凭据索引，默认为空。

EnrolledCredInfo8+

表示已注册凭据的信息。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称类型必填说明
credentialIdUint8Array是指示凭据索引。
authTypeAuthType是指示认证凭据类型。
authSubTypeAuthSubType是指示认证凭据子类型。
templateIdUint8Array是指示凭据模板ID。

GetPropertyType8+

表示要获取的属性类型的枚举。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称值说明
AUTH_SUB_TYPE1认证子类型。
REMAIN_TIMES2剩余时间。
FREEZING_TIME3冻结时间。
ENROLLMENT_PROGRESS10+4录入进度。
SENSOR_INFO10+5传感器信息。

SetPropertyType8+

表示要设置的属性类型的枚举。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称值说明
INIT_ALGORITHM1初始化算法。

AuthType8+

表示身份验证的凭据类型的枚举。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称值说明
PIN1表示PIN认证类型。
FACE2表示脸部认证类型。
FINGERPRINT10+4表示指纹认证类型。
DOMAIN9+1024表示域认证类型。

AuthSubType8+

表示用于认证的凭据子类型的枚举。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称值说明
PIN_SIX10000表示6位凭证。
PIN_NUMBER10001表示自定义数字凭证。
PIN_MIXED10002表示自定义混合凭据。
FACE_2D20000表示2D 人脸凭证。
FACE_3D20001表示3D 人脸凭证。
FINGERPRINT_CAPACITIVE10+30000表示电容式指纹。
FINGERPRINT_OPTICAL10+30001表示光学指纹。
FINGERPRINT_ULTRASONIC10+30002表示超声波指纹。
DOMAIN_MIXED9+10240001表示域认证混合凭证。

AuthTrustLevel8+

表示认证结果的受信任级别的枚举。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称值说明
ATL110000信任级别 1。
ATL220000信任级别 2。
ATL330000信任级别 3。
ATL440000信任级别 4。

Module8+

表示获取信息的模块的枚举。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称值说明
FACE_AUTH1表示从人脸认证获取的信息。

ResultCode8+

表示身份验证结果码。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称值说明
SUCCESS0表示身份验证成功或支持此功能。
FAIL1表示验证器无法识别用户。
GENERAL_ERROR2表示其他错误。
CANCELED3表示身份验证已取消。
TIMEOUT4表示身份验证已超时。
TYPE_NOT_SUPPORT5表示不支持此身份验证类型。
TRUST_LEVEL_NOT_SUPPORT6表示不支持身份验证信任级别。
BUSY7表示身份验证任务正忙。等待几秒钟，然后重试。
INVALID_PARAMETERS8表示参数不正确。
LOCKED9指示身份验证器已锁定。
NOT_ENROLLED10表示用户尚未注册验证器。

FaceTipsCode8+

表示人脸验证过程中提示的枚举。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称值说明
FACE_AUTH_TIP_TOO_BRIGHT1表示由于高照明，获得的面部图像太亮。
FACE_AUTH_TIP_TOO_DARK2表示由于照明度低，获得的面部图像太暗。
FACE_AUTH_TIP_TOO_CLOSE3表示面部离设备太近。
FACE_AUTH_TIP_TOO_FAR4表示面部离设备太远。
FACE_AUTH_TIP_TOO_HIGH5表示设备太高，仅捕捉面部上部。
FACE_AUTH_TIP_TOO_LOW6表示设备太低，仅捕捉面部下部。
FACE_AUTH_TIP_TOO_RIGHT7指示设备向右偏移，并且仅捕捉面部的右侧部分。
FACE_AUTH_TIP_TOO_LEFT8指示设备向左偏移，并且仅捕捉面部的左侧部分。
FACE_AUTH_TIP_TOO_MUCH_MOTION9表示面部信息收集过程中面部移动过快。
FACE_AUTH_TIP_POOR_GAZE10表示面未朝向设备。
FACE_AUTH_TIP_NOT_DETECTED11表示未检测到人脸。

FingerprintTips8+

表示指纹身份验证过程中提示的枚举。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount

名称值说明
FINGERPRINT_TIP_GOOD0表示采集的图像良好。
FINGERPRINT_TIP_IMAGER_DIRTY1表示由于传感器上可疑或检测到污垢，指纹图像噪声过大。
FINGERPRINT_TIP_INSUFFICIENT2表示由于检测到的情况，指纹图像噪声太大，无法处理。
FINGERPRINT_TIP_PARTIAL3表示仅检测到部分指纹图像。
FINGERPRINT_TIP_TOO_FAST4表示指纹图像由于快速运动而不完整。
FINGERPRINT_TIP_TOO_SLOW5表示由于缺少运动，指纹图像无法读取。
FINGERPRINT_TIP_FINGER_DOWN10+6表示手指落下。
FINGERPRINT_TIP_FINGER_UP10+7表示手指抬起。

OsAccountInfo

表示系统帐号信息。

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称类型必填说明
localIdnumber是系统帐号ID。
localNamestring是系统帐号名称。
typeOsAccountType是系统帐号类型。
constraintsArray<string>否系统帐号约束，默认为空。
isVerified8+boolean是帐号是否验证。
photo8+string否系统帐号头像，默认为空。
createTime8+number是系统帐号创建时间。
lastLoginTime8+number否系统帐号最后一次登录时间，默认为空。
serialNumber8+number是系统帐号SN码。
isActived8+boolean是系统帐号激活状态。
isCreateCompleted8+boolean是系统帐号创建是否完整。
distributedInfodistributedAccount.DistributedInfo否分布式帐号信息，默认为空。
domainInfo8+DomainAccountInfo否域帐号信息，默认为空。

DomainAccountInfo8+

表示域帐号信息。

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称类型必填说明
domainstring是域名。
accountNamestring是域帐号名。
accountId10+string否域帐号标识。
系统接口： 此接口为系统接口，默认为空。
isAuthenticated11+boolean否指示域账号是否已认证。
系统接口： 此接口为系统接口，默认为false。

系统帐号约束列表

约束说明
constraint.wifi禁止使用Wi-Fi
constraint.wifi.set禁止配置Wi-Fi
constraint.locale.set禁止配置设备语言
constraint.app.accounts禁止添加和删除应用帐号
constraint.apps.install禁止安装应用
constraint.apps.uninstall禁止卸载应用
constraint.location.shared禁止打开位置共享
constraint.unknown.sources.install禁止安装未知来源的应用
constraint.global.unknown.app.install禁止所有用户安装未知来源的应用
constraint.bluetooth.set禁止配置蓝牙
constraint.bluetooth禁止使用蓝牙
constraint.bluetooth.share禁止共享使用蓝牙
constraint.usb.file.transfer禁止通过USB传输文件
constraint.credentials.set禁止配置用户凭据
constraint.os.account.remove禁止删除用户
constraint.managed.profile.remove禁止删除此用户的托管配置文件
constraint.debug.features.useJ禁止启用或访问调试功能
constraint.vpn.set禁止配置VPN
constraint.date.time.set禁止配置日期时间和时区
constraint.tethering.config禁止配置Tethering
constraint.network.reset禁止重置网络设置
constraint.factory.reset禁止出厂设置
constraint.os.account.create禁止创建新用户
constraint.add.managed.profile禁止添加托管配置文件
constraint.apps.verify.disable强制应用程序验证
constraint.cell.broadcasts.set禁止配置小区广播
constraint.mobile.networks.set禁止配置移动网络
constraint.control.apps禁止在设置或启动模块中修改应用程序
constraint.physical.media禁止装载物理外部介质
constraint.microphone禁止使用麦克风
constraint.microphone.unmute禁止取消麦克风静音
constraint.volume.adjust禁止调整音量
constraint.calls.outgoing禁止拨打外呼电话
constraint.sms.use禁止发送或接收短信
constraint.fun禁止享受乐趣
constraint.windows.create禁止创建应用程序窗口以外的窗口
constraint.system.error.dialogs禁止显示崩溃或无响应应用程序的系统错误对话框
constraint.cross.profile.copy.paste禁止通过将数据粘贴到其他用户或配置文件来导出剪贴板内容
constraint.beam.outgoing禁止使用NFC从应用程序传送数据
constraint.wallpaper禁止管理壁纸
constraint.safe.boot禁止进入安全引导模式
constraint.parent.profile.app.linking允许父配置文件中的应用程序处理来自托管配置文件的Web链接
constraint.audio.record禁止录制音频
constraint.camera.use禁止使用摄像机
constraint.os.account.background.run禁止在后台运行
constraint.data.roam禁止漫游通话时使用蜂窝数据
constraint.os.account.set.icon禁止修改用户头像
constraint.wallpaper.set禁止设置壁纸
constraint.oem.unlock禁止启用oem解锁
constraint.device.unmute禁止取消设备静音
constraint.password.unified禁止托管配置文件与主用户进行统一锁屏质询
constraint.autofill禁止使用自动填充服务
constraint.content.capture禁止捕获用户屏幕
constraint.content.suggestions禁止接收内容建议
constraint.os.account.start禁止切换用户
constraint.location.set禁止配置位置服务
constraint.airplane.mode.set禁止飞行模式
constraint.brightness.set禁止配置亮度
constraint.share.into.profile禁止将主要用户的文件/图片/数据共享到托管配置文件中
constraint.ambient.display禁止显示环境
constraint.screen.timeout.set禁止配置屏幕关闭的超时
constraint.print禁止打印
constraint.private.dns.set禁止配置专用DNS

ConstraintSourceTypeInfo9+

表示约束来源类型信息。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称类型必填说明
localIdnumber是系统帐号ID
typeConstraintSourceType是约束来源类型

ConstraintSourceType9+

表示约束来源类型的枚举。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称值说明
CONSTRAINT_NOT_EXIST0约束不存在
CONSTRAINT_TYPE_BASE1约束源自系统设置
CONSTRAINT_TYPE_DEVICE_OWNER2约束源自设备所有者设置
CONSTRAINT_TYPE_PROFILE_OWNER3约束源自资料所有者设置

AuthStatusInfo10+

表示认证状态信息。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称类型必填说明
remainTimesnumber是剩余次数
freezingTimenumber是冻结时间

GetDomainAccessTokenOptions10+

表示获取域访问令牌的选项。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称类型必填说明
domainAccountInfoDomainAccountInfo是域帐号的信息
domainAccountTokenUint8Array是域帐号的令牌
businessParams{ [key: string]: object }是业务参数，由业务方根据请求协议自定义
callerUidnumber是调用方唯一标识符

GetDomainAccountInfoOptions10+

表示查询域帐号信息的选项。

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称类型必填说明
accountNamestring是域帐号名。
domainstring否域名。

GetDomainAccountInfoPluginOptions10+

表示插件查询域帐号信息的选项。GetDomainAccountInfoPluginOptions类继承GetDomainAccountInfoOptions

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

系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称类型必填说明
callerUidnumber是调用方唯一标识符

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

  • 所属分类： 后端技术
  • 本文标签： 鸿蒙 软件
  • 版权声明： 本文链接 https://seaxiang.com/blog/c694555c87bb451983f3c8e1078fef4e