1# oh_device_manager.h 2 3## 概述 4 5提供访问可信设备和本地设备信息的接口。 6 7**引用文件：** <distributedhardware/device_manager/oh_device_manager.h> 8 9**库：** libdevicemanager_ndk.so 10 11**系统能力：** SystemCapability.DistributedHardware.DeviceManager 12 13**起始版本：** 20 14 15**相关模块：** [DeviceManager](capi-devicemanager.md) 16 17## 汇总 18 19### 函数 20 21| 名称 | 描述 | 22| -- | -- | 23| [int32_t OH_DeviceManager_GetLocalDeviceName(char **localDeviceName, unsigned int &len)](#oh_devicemanager_getlocaldevicename) | 获取本地设备显示名。<br>设备显示名称涉及用户的隐私数据，需要应用提供相关隐私声明，声明设备显示名的用途。 | 24 25## 函数说明 26 27### OH_DeviceManager_GetLocalDeviceName() 28 29``` 30int32_t OH_DeviceManager_GetLocalDeviceName(char **localDeviceName, unsigned int &len) 31``` 32 33**描述** 34 35获取本地设备显示名。<br>设备显示名称涉及用户的隐私数据，需要应用提供相关隐私声明，声明设备显示名的用途。 36 37**需要权限：** ohos.permission.READ_LOCAL_DEVICE_NAME 38 39**起始版本：** 20 40 41 42**参数：** 43 44| 参数项 | 描述 | 45| -- | -- | 46| char **localDeviceName | 表示本地设备显示名字符串的地址指针。使用后需要手动释放空间资源。应用具备 ohos.permission.READ_LOCAL_DEVICE_NAME 权限，返回设备显示名称；否则返回设备默认名称。 | 47| unsigned int &len | 表示本地设备显示名字符串的长度。 | 48 49**返回：** 50 51| 类型 | 说明 | 52| -- |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| 53| int32_t | 返回执行的错误码。错误码定义详见[DeviceManager_ErrorCode](capi-oh-device-manager-err-code-h.md#devicemanager_errorcode)。<br> 返回[ERR_OK](capi-oh-device-manager-err-code-h.md#devicemanager_errorcode)，表示执行成功。<br> 返回[DM_ERR_FAILED](capi-oh-device-manager-err-code-h.md#devicemanager_errorcode)，表示函数执行失败。<br> 返回[DM_ERR_OBTAIN_SERVICE](capi-oh-device-manager-err-code-h.md#devicemanager_errorcode)，表示获取设备管理服务失败。<br> 返回[DM_ERR_OBTAIN_BUNDLE_NAME](capi-oh-device-manager-err-code-h.md#devicemanager_errorcode)，表示获取bundleName失败。 | 54 55 56