AccountAbility

java.lang.Object
- ohos.account.AccountAbility

```
public class AccountAbility
extends Object
```
Provides abilities for you to manage and perform operations on your OS accounts.
This class provides basic account-related functions, including querying and updating the distributed information of an OS account in a distributed system, creating, removing, and starting an OS account, updating OS account information, and querying information about the current OS account or all OS accounts. The distributed information refers to the account information that is used on a distributed network. It affects the availability of the distributed network and the distributed database.

从以下版本开始:

1

SystemCapability

SystemCapability.Account#OS_ACCOUNT

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`static AccountAbility`	`getAccountAbility()`	Obtains the `AccountAbility` instance.
`int`	`getAllCreatedOsAccounts()`	Obtains the number of all OS accounts created on a device.
`String`	`getDistributedVirtualDeviceId()`	Obtains the distributed virtual device ID (DVID).
`List<String>`	`getOsAccountAllConstraints(int localId)`	Obtains all constraints of an OS account based on its local ID.
`int`	`getOsAccountLocalIdFromProcess()`	Obtains the local ID of an OS account from the current process UID.
`int`	`getOsAccountLocalIdFromUid(int uid)`	Queries the local ID of an OS account from the process UID.
`OsAccountType`	`getOsAccountTypeFromProcess()`	Obtains the type of this OS account from the current process.
`boolean`	`isMultiOSAccountEnable()`	Checks whether the function of supporting multiple OS accounts is enabled.
`boolean`	`isOsAccountActive(int localId)`	Checks whether an OS account is active based on its local ID.
`boolean`	`isOsAccountConstraintEnable(int localId, String constraint)`	Checks whether a constraint has been enabled for an OS account based on its local ID.
`boolean`	`isOsAccountKingKong()`	Checks whether this OS account is a King Kong user.
`boolean`	`isOsAccountVerified()`	Checks whether this OS account has been verified.
`boolean`	`isOsAccountVerified(int localId)`	Checks whether an OS account has been verified based on its local ID.
`OsAccount`	`queryCurrentOsAccount()`	Queries information about the current OS account.
`DistributedInfo`	`queryOsAccountDistributedInfo()`	Queries the distributed information of the current OS account.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - queryOsAccountDistributedInfo
```
public DistributedInfo queryOsAccountDistributedInfo()
```
    Queries the distributed information of the current OS account.
    Your application needs to request the ohos.permission.MANAGE_LOCAL_ACCOUNTS or ohos.security.SystemPermission.DISTRIBUTED_DATASYNC permission.
    
    返回:
    
    Returns the distributed information of the current OS account; returns null if the query fails.
  - isMultiOSAccountEnable
```
public boolean isMultiOSAccountEnable()
```
    Checks whether the function of supporting multiple OS accounts is enabled.
    
    返回:
    
    Returns true if this function is enabled; returns false otherwise.
  - getOsAccountLocalIdFromUid
```
public int getOsAccountLocalIdFromUid(int uid)
```
    Queries the local ID of an OS account from the process UID.
    
    参数:
    
    uid - Indicates the process UID.
    
    返回:
    
    Returns the local ID of the OS account.
  - queryCurrentOsAccount
```
public OsAccount queryCurrentOsAccount()
```
    Queries information about the current OS account.
    Your application needs to request the ohos.permission.MANAGE_LOCAL_ACCOUNTS permission.
    
    返回:
    
    Returns information about the current OS account; returns null if the query fails.
  - isOsAccountConstraintEnable
```
public boolean isOsAccountConstraintEnable(int localId,
                                           String constraint)
```
    Checks whether a constraint has been enabled for an OS account based on its local ID.
    Your application needs to request the ohos.permission.MANAGE_LOCAL_ACCOUNTS permission.
    参数:
    
    localId - Indicates the local ID of the OS account.
    constraint - Indicates the constraint to check. The value can be:
    
    constraint.wifi.set - Indicates the constraint on configuring the Wi-Fi access point.
    
    constraint.sms.use - Indicates the constraint on sending and receiving short messages.
    
    constraint.calls.outgoing - Indicates the constraint on making calls.
    
    constraint.unknown.sources.install - Indicates the constraint on installing applications from unknown sources.
    返回:
    
    Returns true if the constraint has been enabled for the OS account; returns false otherwise.
  - getOsAccountAllConstraints
```
public List<String> getOsAccountAllConstraints(int localId)
```
    Obtains all constraints of an OS account based on its local ID.
    Your application needs to request the ohos.permission.MANAGE_LOCAL_ACCOUNTS permission.
    
    参数:
    
    localId - Indicates the local ID of the OS account.
    
    返回:
    
    Returns a list of constraints.
  - getAllCreatedOsAccounts
```
public int getAllCreatedOsAccounts()
```
    Obtains the number of all OS accounts created on a device.
    Your application needs to request the ohos.permission.MANAGE_LOCAL_ACCOUNTS permission.
    
    返回:
    
    Returns the number of created OS accounts.
  - getOsAccountLocalIdFromProcess
```
public int getOsAccountLocalIdFromProcess()
```
    Obtains the local ID of an OS account from the current process UID.
    
    返回:
    
    Returns the local ID of the OS account.
  - isOsAccountActive
```
public boolean isOsAccountActive(int localId)
```
    Checks whether an OS account is active based on its local ID.
    Your application needs to request the ohos.permission.MANAGE_LOCAL_ACCOUNTS or ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS permission.
    
    参数:
    
    localId - Indicates the local ID of the OS account.
    
    返回:
    
    Returns true if the OS account is active; returns false otherwise.
  - isOsAccountKingKong
```
public boolean isOsAccountKingKong()
```
    Checks whether this OS account is a King Kong user.
    
    返回:
    
    Returns true if this OS account is a King Kong user; returns false otherwise.
  - isOsAccountVerified
```
public boolean isOsAccountVerified()
```
    Checks whether this OS account has been verified.
    
    返回:
    
    Returns true if the OS account has been verified successfully; returns false otherwise.
  - isOsAccountVerified
```
public boolean isOsAccountVerified(int localId)
```
    Checks whether an OS account has been verified based on its local ID.
    Your application needs to request the ohos.permission.MANAGE_LOCAL_ACCOUNTS or ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS permission.
    
    参数:
    
    localId - Indicates the local ID of the OS account.
    
    返回:
    
    Returns true if the OS account has been verified successfully; returns false otherwise.
  - getOsAccountTypeFromProcess
```
public OsAccountType getOsAccountTypeFromProcess()
```
    Obtains the type of this OS account from the current process.
    
    返回:
    
    Returns the OS account type. The value can be OsAccountType#ADMIN, OsAccountType#NORMAL, and OsAccountType#GUEST.
  - getDistributedVirtualDeviceId
```
public String getDistributedVirtualDeviceId()
```
    Obtains the distributed virtual device ID (DVID).
    If the same OHOS account has logged in to multiple devices, these devices constitute a super device through the distributed networking. On the networked devices, you can call this method to obtain the DVIDs. The same application running on different devices obtains the same DVID, whereas different applications obtain different DVIDs.
    Permissions: SystemPermission.DISTRIBUTED_DATASYNC
    
    返回:
    
    Returns the DVID if obtained; returns an empty string if no OHOS account has logged in.
    
    从以下版本开始:
    
    5
  - getAccountAbility
```
public static AccountAbility getAccountAbility()
```
    Obtains the AccountAbility instance.
    
    返回:
    
    Returns the AccountAbility instance.

类 AccountAbility

方法概要

从类继承的方法 java.lang.Object

方法详细资料

queryOsAccountDistributedInfo

isMultiOSAccountEnable

getOsAccountLocalIdFromUid

queryCurrentOsAccount

isOsAccountConstraintEnable

getOsAccountAllConstraints

getAllCreatedOsAccounts

getOsAccountLocalIdFromProcess

isOsAccountActive

isOsAccountKingKong

isOsAccountVerified

isOsAccountVerified

getOsAccountTypeFromProcess

getDistributedVirtualDeviceId

getAccountAbility