HarmonyOS API:@ohos.account.osAccount (系统帐号管理)
版本: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 | 是 | 域帐号信息。 | |
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 | 是 | 域帐号信息。 |
返回值:
类型 | 说明 |
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 | 是 | 系统帐号类型 | |
constraints | Array<string> | 否 | 系统帐号约束 |
isVerified8+ | boolean | 是 | 帐号是否锁屏 |
photo8+ | string | 否 | 系统帐号头像 |
createTime8+ | number | 是 | 系统帐号创建时间 |
lastLoginTime8+ | number | 否 | 系统帐号最后一次登录时间 |
serialNumber8+ | number | 是 | 系统帐号SN码 |
isActived8+ | boolean | 是 | 系统帐号激活状态 |
isCreateCompleted8+ | boolean | 是 | 系统帐号创建是否完整 |
domainInfo8+ | 否 | 域帐号信息 |
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 |