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

joytrian
发布于 2023-4-10 18:28
浏览
0收藏

版本:v3.1 Beta

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

querySerialNumberByOsAccountLocalId9+

querySerialNumberByOsAccountLocalId(localId: number): Promise<number>

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

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

返回值:

类型

说明

Promise<number>

Promise对象,返回与该系统帐号关联的SN码。

错误码:

错误码ID

错误信息

12300001

System service exception.

12300002

Invalid localId.

12300003

Account not found.

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

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
try {
  accountManager.querySerialNumberByOsAccountLocalId(localId).then((serialNumber) => {
    console.log('querySerialNumberByOsAccountLocalId serialNumber: ' + serialNumber);
  }).catch((err) => {
    console.log('querySerialNumberByOsAccountLocalId err: '  + JSON.stringify(err));
  });
} catch (e) {
  console.log('querySerialNumberByOsAccountLocalId exception:' + JSON.stringify(e));
}

isMultiOsAccountEnable(deprecated)

isMultiOsAccountEnable(callback: AsyncCallback<boolean>): void

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

说明

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

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

callback

AsyncCallback<boolean>

回调函数。返回true表示支持多系统帐号;返回false表示不支持。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.isMultiOsAccountEnable((err, isEnabled) => {
  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表示不支持。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.isMultiOsAccountEnable().then((isEnabled) => {
  console.log('isMultiOsAccountEnable successfully, isEnabled: ' + isEnabled);
}).catch((err) => {
  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

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

callback

AsyncCallback<boolean>

回调函数。返回true表示帐号已激活;返回false表示帐号未激活。

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

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
accountManager.isOsAccountActived(localId, (err, isActived) => {
  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

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

返回值:

类型

说明

Promise<boolean>

Promise对象。返回true表示帐号已激活;返回false表示帐号未激活。

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

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
accountManager.isOsAccountActived(localId).then((isActived) => {
  console.log('isOsAccountActived successfully, isActived: ' + isActived);
}).catch((err) => {
  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开始废弃。建议使用​​checkConstraintEnabled​​。

需要权限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

constraint

string

指定的约束名称。

callback

AsyncCallback<boolean>

回调函数。返回true表示已使能指定的约束;返回false表示未使能指定的约束。

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

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
let constraint = "constraint.wifi";
accountManager.isOsAccountConstraintEnable(localId, constraint, (err, isEnabled) => {
  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开始废弃。建议使用​​checkConstraintEnabled​​。

需要权限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

constraint

string

指定的约束名称。

返回值:

类型

说明

Promise<boolean>

Promise对象。返回true表示已使能指定的约束;返回false表示未使能指定的约束。

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

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
let constraint = "constraint.wifi";
accountManager.isOsAccountConstraintEnable(localId, constraint).then((isEnabled) => {
  console.log("isOsAccountConstraintEnable successfully, isEnabled: " + isEnabled);
}).catch((err) => {
  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

参数:

参数名

类型

必填

说明

callback

AsyncCallback<boolean>

回调函数。返回true表示当前帐号为测试帐号;返回false表示当前帐号非测试帐号。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.isTestOsAccount((err, isTestable) => {
  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表示当前帐号非测试帐号。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.isTestOsAccount().then((isTestable) => {
    console.log("isTestOsAccount successfully, isTestable: " + isTestable);
}).catch((err) => {
    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

参数:

参数名

类型

必填

说明

callback

AsyncCallback<boolean>

回调函数。返回true表示指定帐号已验证;返回false表示指定帐号未验证。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified((err, isVerified) => {
  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

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

callback

AsyncCallback<boolean>

回调函数。返回true表示指定帐号已验证;返回false表示指定帐号未验证。

示例:

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
accountManager.isOsAccountVerified(localId, (err, isVerified) => {
  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

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。不填则检查当前系统帐号是否已验证。

返回值:

类型

说明

Promise<boolean>

Promise对象。返回true表示指定帐号已验证;返回false表示指定帐号未验证。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified(localId).then((isVerified) => {
  console.log("isOsAccountVerified successfully, isVerified: " + isVerified);
}).catch((err) => {
  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

参数:

参数名

类型

必填

说明

callback

AsyncCallback<number>

回调函数。当获取成功时,err为null,data为已创建的系统帐号的数量;否则为错误对象。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.getCreatedOsAccountsCount((err, count)=>{
  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对象,返回已创建的系统帐号的数量。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.getCreatedOsAccountsCount().then((count) => {
  console.log("getCreatedOsAccountsCount successfully, count: " + count);
}).catch((err) => {
  console.log("getCreatedOsAccountsCount failed, error: "  + JSON.stringify(err));
});

getOsAccountLocalIdFromProcess(deprecated)

getOsAccountLocalIdFromProcess(callback: AsyncCallback<number>): void

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

说明

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

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

callback

AsyncCallback<number>

回调函数。当获取成功时,err为null,data为当前进程所属的系统帐号ID;否则为错误对象。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromProcess((err, localId) => {
  if (err) {
    console.log("getOsAccountLocalIdFromProcess failed, error: " + JSON.stringify(err));
  } else {
    console.log("getOsAccountLocalIdFromProcess successfully, localId: " + localId);
  }
});

getOsAccountLocalIdFromProcess(deprecated)

getOsAccountLocalIdFromProcess(): Promise<number>

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

说明

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

系统能力: SystemCapability.Account.OsAccount

返回值:

类型

说明

Promise<number>

Promise对象,返回当前进程所属的系统帐号ID。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromProcess().then((localId) => {
  console.log('getOsAccountLocalIdFromProcess successfully, localId: ' + localId);
}).catch((err) => {
  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开始废弃。建议使用​​queryOsAccountLocalIdFromUid​​。

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

uid

number

进程uid。

callback

AsyncCallback<number>

回调函数。如果查询成功,err为null,data为对应的系统帐号ID;否则为错误对象。

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

let accountManager = account_osAccount.getAccountManager();
let uid = 12345678;
accountManager.getOsAccountLocalIdFromUid(uid, (err, localId) => {
  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开始废弃。建议使用​​queryOsAccountLocalIdFromUid​​。

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

uid

number

进程uid。

返回值:

类型

说明

Promise<number>

Promise对象,返回uid对应的系统帐号ID。

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

let accountManager = account_osAccount.getAccountManager();
let uid = 12345678;
accountManager.getOsAccountLocalIdFromUid(uid).then((localId) => {
  console.log("getOsAccountLocalIdFromUid successfully, localId: " + localId);
}).catch((err) => {
  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开始废弃。建议使用​​queryOsAccountLocalIdFromDomain​​。

需要权限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

domainInfo

​DomainAccountInfo​

域帐号信息。

callback

AsyncCallback<number>

回调函数,如果获取成功,err为null,data为域帐号关联的系统帐号ID;否则为错误对象。

示例:

let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromDomain(domainInfo, (err, localId) => {
  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开始废弃。建议使用​​queryOsAccountLocalIdFromDomain​​。

需要权限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

domainInfo

​DomainAccountInfo​

域帐号信息。

返回值:

类型

说明

Promise<number>

Promise对象,返回域帐号关联的系统帐号ID。

示例:

let accountManager = account_osAccount.getAccountManager();
let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
accountManager.getOsAccountLocalIdFromDomain(domainInfo).then((localId) => {
  console.log('getOsAccountLocalIdFromDomain successfully, localId: ' + localId);
}).catch((err) => {
  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

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

callback

AsyncCallback<Array<string>>

回调函数。如果获取成功,err为null,data为指定系统帐号的全部约束;否则为错误对象。

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

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
accountManager.getOsAccountAllConstraints(localId, (err, constraints)=>{
  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

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

返回值:

类型

说明

Promise<Array<string>>

Promise对象,返回指定系统帐号的全部约束。

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

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
accountManager.getOsAccountAllConstraints(localId).then((constraints) => {
  console.log('getOsAccountAllConstraints, constraints: ' + constraints);
}).catch((err) => {
  console.log('getOsAccountAllConstraints err: '  + JSON.stringify(err));
});

queryActivatedOsAccountIds(deprecated)

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

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

说明

从 API version 8开始支持,从API version 9开始废弃。建议使用​​getActivatedOsAccountIds​​。

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

callback

AsyncCallback<Array<number>>

回调函数。如果查询成功,err为null,data为当前处于激活状态的系统帐号的ID列表;否则为错误对象。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.queryActivatedOsAccountIds((err, idArray)=>{
  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开始废弃。建议使用​​getActivatedOsAccountIds​​。

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

系统能力: SystemCapability.Account.OsAccount

返回值:

类型

说明

Promise<Array<number>>

Promise对象,返回当前处于激活状态的系统帐号的ID列表。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.queryActivatedOsAccountIds().then((idArray) => {
  console.log('queryActivatedOsAccountIds, idArray: ' + idArray);
}).catch((err) => {
  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

参数:

参数名

类型

必填

说明

callback

AsyncCallback<​​OsAccountInfo​​>

回调函数。如果查询成功,err为null,data为当前进程所属的系统帐号信息;否则为错误对象。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.queryCurrentOsAccount((err, curAccountInfo)=>{
  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对象,返回当前进程所属的系统帐号信息。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.queryCurrentOsAccount().then((accountInfo) => {
  console.log('queryCurrentOsAccount, accountInfo: ' + JSON.stringify(accountInfo));
}).catch((err) => {
  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

参数:

参数名

类型

必填

说明

callback

AsyncCallback<​​OsAccountType​​>

回调函数。如果查询成功,err为null,data为当前进程所属的系统帐号的帐号类型;否则为错误对象。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountTypeFromProcess((err, accountType) => {
  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对象,返回当前进程所属的系统帐号的帐号类型。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountTypeFromProcess().then((accountType) => {
  console.log('getOsAccountTypeFromProcess, accountType: ' + accountType);
}).catch((err) => {
  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

参数:

参数名

类型

必填

说明

callback

AsyncCallback<string>

回调函数。如果获取成功,err为null,data为分布式虚拟设备ID;否则为错误对象。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.getDistributedVirtualDeviceId((err, virtualID) => {
  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。

示例:

let accountManager = account_osAccount.getAccountManager();
accountManager.getDistributedVirtualDeviceId().then((virtualID) => {
  console.log('getDistributedVirtualDeviceId, virtualID: ' + virtualID);
}).catch((err) => {
  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开始废弃。建议使用​​queryOsAccountLocalIdBySerialNumber​​。

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

serialNumber

number

帐号SN码。

callback

AsyncCallback<number>

回调函数。如果查询成功,err为null,data为与SN码关联的系统帐号的帐号ID;否则为错误对象。

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

let accountManager = account_osAccount.getAccountManager();
let serialNumber = 12345;
accountManager.getOsAccountLocalIdBySerialNumber(serialNumber, (err, localId)=>{
  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开始废弃。建议使用​​queryOsAccountLocalIdBySerialNumber​​。

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

serialNumber

number

帐号SN码。

返回值:

类型

说明

Promise<number>

Promise对象,返回与SN码关联的系统帐号的帐号ID。

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

let accountManager = account_osAccount.getAccountManager();
let serialNumber = 12345;
accountManager.getOsAccountLocalIdBySerialNumber(serialNumber).then((localId) => {
  console.log('getOsAccountLocalIdBySerialNumber localId: ' + localId);
}).catch((err) => {
  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开始废弃。建议使用​​querySerialNumberByOsAccountLocalId​​。

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

callback

AsyncCallback<number>

回调函数。如果获取成功,err为null,data为与该系统帐号关联的SN码;否则为错误对象。

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

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
accountManager.getSerialNumberByOsAccountLocalId(localId, (err, serialNumber)=>{
  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开始废弃。建议使用​​querySerialNumberByOsAccountLocalId​​。

系统能力: SystemCapability.Account.OsAccount

参数:

参数名

类型

必填

说明

localId

number

系统帐号ID。

返回值:

类型

说明

Promise<number>

Promise对象,返回与该系统帐号关联的SN码。

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

let accountManager = account_osAccount.getAccountManager();
let localId = 100;
accountManager.getSerialNumberByOsAccountLocalId(localId).then((serialNumber) => {
  console.log('getSerialNumberByOsAccountLocalId serialNumber: ' + serialNumber);
}).catch((err) => {
  console.log('getSerialNumberByOsAccountLocalId err: '  + JSON.stringify(err));
});

OsAccountInfo

表示系统帐号信息。

系统能力: 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称

类型

必填

说明

localId

number

系统帐号ID。

localName

string

系统帐号名称。

type

​OsAccountType​

系统帐号类型

constraints

Array<string>

系统帐号约束

isVerified8+

boolean

帐号是否锁屏

photo8+

string

系统帐号头像

createTime8+

number

系统帐号创建时间

lastLoginTime8+

number

系统帐号最后一次登录时间

serialNumber8+

number

系统帐号SN码

isActived8+

boolean

系统帐号激活状态

isCreateCompleted8+

boolean

系统帐号创建是否完整

domainInfo8+

​DomainAccountInfo​

域帐号信息

DomainAccountInfo8+

表示域帐号信息。

系统能力: 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

名称

类型

必填

说明

domain

string

域名。

accountName

string

域帐号名。

系统帐号约束列表

约束

说明

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.use

J禁止启用或访问调试功能

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


文章转载自:​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-osaccount-0000001478341429-V3?catalogVersion=V3#ZH-CN_TOPIC_0000001478341429__系统帐号约束列表​

已于2023-4-10 18:28:37修改
收藏
回复
举报
回复
    相关推荐