harmony 鸿蒙oh_device_manager.h

2025-06-12
浏览 (3)

oh_device_manager.h

概述

提供访问可信设备和本地设备信息的接口。

引用文件：

库： libnative_devicemanager.so

系统能力： SystemCapability.DistributedHardware.DeviceManager

起始版本： 20

相关模块： DeviceManager

汇总

函数

|名称|描述| |–|–| |int32_t OH_DeviceManager_GetLocalDeviceName(char **localDeviceName, unsigned int &len)|获取本地设备显示名。
设备显示名称涉及用户的隐私数据，需要应用提供相关隐私声明，声明设备显示名的用途。|

函数说明

OH_DeviceManager_GetLocalDeviceName()

int32_t OH_DeviceManager_GetLocalDeviceName(char **localDeviceName, unsigned int &len)

描述

获取本地设备显示名。
设备显示名称涉及用户的隐私数据，需要应用提供相关隐私声明，声明设备显示名的用途。

需要权限： ohos.permission.READ_LOCAL_DEVICE_NAME

起始版本： 20

参数：

|参数项|描述| |–|–| |char **localDeviceName|表示本地设备显示名字符串的地址指针。使用后需要手动释放空间资源。应用具备 ohos.permission.READ_LOCAL_DEVICE_NAME 权限，返回设备显示名称；否则返回设备默认名称。| |unsigned int &len|表示本地设备显示名字符串的长度。|

返回：

|类型|说明 | |–|——————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————| |int32_t|返回执行的错误码。错误码定义详见DeviceManager_ErrorCode。
返回ERR_OK，表示执行成功。
返回ERR_INVALID_PARAMETER，表示传入了无效参数。
返回DM_ERR_FAILED，表示函数执行失败。
返回DM_ERR_OBTAIN_SERVICE，表示获取设备管理服务失败。
返回DM_ERR_OBTAIN_BUNDLE_NAME，表示获取bundleName失败。|