1e41f4b71Sopenharmony_ci# OsAccount 2e41f4b71Sopenharmony_ci 3e41f4b71Sopenharmony_ci 4e41f4b71Sopenharmony_ci## 概述 5e41f4b71Sopenharmony_ci 6e41f4b71Sopenharmony_ci描述OsAccount向应用提供系统账号能力。 7e41f4b71Sopenharmony_ci 8e41f4b71Sopenharmony_ci**起始版本：** 12 9e41f4b71Sopenharmony_ci 10e41f4b71Sopenharmony_ci 11e41f4b71Sopenharmony_ci## 汇总 12e41f4b71Sopenharmony_ci 13e41f4b71Sopenharmony_ci 14e41f4b71Sopenharmony_ci### 文件 15e41f4b71Sopenharmony_ci 16e41f4b71Sopenharmony_ci| 名称 | 描述 | 17e41f4b71Sopenharmony_ci| -------- | -------- | 18e41f4b71Sopenharmony_ci| [os_account.h](os__account_8h.md) | 声明访问和管理系统账号信息的API。 | 19e41f4b71Sopenharmony_ci| [os_account_common.h](os__account__common_8h.md) | 提供OsAccount接口的公共类型定义。 | 20e41f4b71Sopenharmony_ci 21e41f4b71Sopenharmony_ci 22e41f4b71Sopenharmony_ci### 类型定义 23e41f4b71Sopenharmony_ci 24e41f4b71Sopenharmony_ci| 名称 | 描述 | 25e41f4b71Sopenharmony_ci| -------- | -------- | 26e41f4b71Sopenharmony_ci| typedef enum [OsAccount_ErrCode](#osaccount_errcode-1) [OsAccount_ErrCode](#osaccount_errcode) | 枚举错误码。 | 27e41f4b71Sopenharmony_ci 28e41f4b71Sopenharmony_ci 29e41f4b71Sopenharmony_ci### 枚举 30e41f4b71Sopenharmony_ci 31e41f4b71Sopenharmony_ci| 名称 | 描述 | 32e41f4b71Sopenharmony_ci| -------- | -------- | 33e41f4b71Sopenharmony_ci| [OsAccount_ErrCode](#osaccount_errcode-1) {<br/>OS_ACCOUNT_ERR_OK = 0,<br/>OS_ACCOUNT_ERR_INTERNAL_ERROR = 12300001,<br/>OS_ACCOUNT_ERR_INVALID_PARAMETER = 12300002<br/>} | 枚举错误码。 | 34e41f4b71Sopenharmony_ci 35e41f4b71Sopenharmony_ci 36e41f4b71Sopenharmony_ci### 函数 37e41f4b71Sopenharmony_ci 38e41f4b71Sopenharmony_ci| 名称 | 描述 | 39e41f4b71Sopenharmony_ci| -------- | -------- | 40e41f4b71Sopenharmony_ci| [OsAccount_ErrCode](#osaccount_errcode) [OH_OsAccount_GetName](#oh_osaccount_getname) (char \*buffer, size_t buffer_size) | 获取调用方进程所属的系统账号的名称。 | 41e41f4b71Sopenharmony_ci 42e41f4b71Sopenharmony_ci 43e41f4b71Sopenharmony_ci## 类型定义说明 44e41f4b71Sopenharmony_ci 45e41f4b71Sopenharmony_ci 46e41f4b71Sopenharmony_ci### OsAccount_ErrCode 47e41f4b71Sopenharmony_ci 48e41f4b71Sopenharmony_ci``` 49e41f4b71Sopenharmony_citypedef enum OsAccount_ErrCode OsAccount_ErrCode 50e41f4b71Sopenharmony_ci``` 51e41f4b71Sopenharmony_ci 52e41f4b71Sopenharmony_ci**描述** 53e41f4b71Sopenharmony_ci 54e41f4b71Sopenharmony_ci枚举错误码。 55e41f4b71Sopenharmony_ci 56e41f4b71Sopenharmony_ci**起始版本：** 12 57e41f4b71Sopenharmony_ci 58e41f4b71Sopenharmony_ci 59e41f4b71Sopenharmony_ci## 枚举类型说明 60e41f4b71Sopenharmony_ci 61e41f4b71Sopenharmony_ci 62e41f4b71Sopenharmony_ci### OsAccount_ErrCode 63e41f4b71Sopenharmony_ci 64e41f4b71Sopenharmony_ci``` 65e41f4b71Sopenharmony_cienum OsAccount_ErrCode 66e41f4b71Sopenharmony_ci``` 67e41f4b71Sopenharmony_ci 68e41f4b71Sopenharmony_ci**描述** 69e41f4b71Sopenharmony_ci 70e41f4b71Sopenharmony_ci枚举错误码。 71e41f4b71Sopenharmony_ci 72e41f4b71Sopenharmony_ci**起始版本：** 12 73e41f4b71Sopenharmony_ci 74e41f4b71Sopenharmony_ci| 枚举值 | 描述 | 75e41f4b71Sopenharmony_ci| -------- | -------- | 76e41f4b71Sopenharmony_ci| OS_ACCOUNT_ERR_OK | 成功。 | 77e41f4b71Sopenharmony_ci| OS_ACCOUNT_ERR_INTERNAL_ERROR | 内部错误。 | 78e41f4b71Sopenharmony_ci| OS_ACCOUNT_ERR_INVALID_PARAMETER | 无效的参数。 | 79e41f4b71Sopenharmony_ci 80e41f4b71Sopenharmony_ci 81e41f4b71Sopenharmony_ci## 函数说明 82e41f4b71Sopenharmony_ci 83e41f4b71Sopenharmony_ci 84e41f4b71Sopenharmony_ci### OH_OsAccount_GetName() 85e41f4b71Sopenharmony_ci 86e41f4b71Sopenharmony_ci``` 87e41f4b71Sopenharmony_ciOsAccount_ErrCode OH_OsAccount_GetName (char *buffer, size_t buffer_size) 88e41f4b71Sopenharmony_ci``` 89e41f4b71Sopenharmony_ci 90e41f4b71Sopenharmony_ci**描述** 91e41f4b71Sopenharmony_ci 92e41f4b71Sopenharmony_ci获取调用方进程所属的系统账号的名称。 93e41f4b71Sopenharmony_ci 94e41f4b71Sopenharmony_ci**系统能力：** SystemCapability.Account.OsAccount 95e41f4b71Sopenharmony_ci 96e41f4b71Sopenharmony_ci**起始版本：** 12 97e41f4b71Sopenharmony_ci 98e41f4b71Sopenharmony_ci**参数:** 99e41f4b71Sopenharmony_ci 100e41f4b71Sopenharmony_ci| 名称 | 描述 | 101e41f4b71Sopenharmony_ci| -------- | -------- | 102e41f4b71Sopenharmony_ci| buffer | 名称字符数组，其应具有能够存放名称（最大长度为LOGIN_NAME_MAX）和结束字符（'\0'）的空间。 | 103e41f4b71Sopenharmony_ci| buffer_size | 名称字符数组的大小。 | 104e41f4b71Sopenharmony_ci 105e41f4b71Sopenharmony_ci**返回：** 106e41f4b71Sopenharmony_ci 107e41f4b71Sopenharmony_ci返回OS_ACCOUNT_ERR_OK表示成功；返回OS_ACCOUNT_ERR_INTERNAL_ERROR表示内部错误；返回OS_ACCOUNT_ERR_INVALID_PARAMETER指示buffer为NULL指针或名称（不包括结束字符（'\0'））的大小大于或等于buffer_size。 108