文档管理中心
您当前正在浏览HarmonyOS最新文档,覆盖已发布的所有API版本,可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明
开发与测试开放能力API系统网络Distributed Service Kit(分布式管理服务)C API头文件oh_device_manager.h

oh_device_manager.h

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

概述

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

引用文件: <distributedhardware/device_manager/oh_device_manager.h>

库: libdevicemanager_ndk.so

系统能力: SystemCapability.DistributedHardware.DeviceManager

起始版本: 20

相关模块: DeviceManager

汇总

函数

展开
名称 描述
int32_t OH_DeviceManager_GetLocalDeviceName(char **localDeviceName, unsigned int &len)

获取本地设备显示名。

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

int32_t OH_DeviceManager_GetLocalDeviceNameC(char **localDeviceName, unsigned int *len)

获取本地设备显示名。

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

函数说明

OH_DeviceManager_GetLocalDeviceName()

Phone20+PC/2in120+Tablet20+TV20+Wearable20+
int32_t OH_DeviceManager_GetLocalDeviceName(char **localDeviceName, unsigned int &len)

描述

获取本地设备显示名。

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

需要权限: ohos.permission.READ_LOCAL_DEVICE_NAME

起始版本: 20

废弃版本: 26.0.0

替代接口: OH_DeviceManager_GetLocalDeviceNameC

参数:

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

返回:

展开
类型 说明
int32_t

返回执行的错误码。错误码定义详见DeviceManager_ErrorCode

返回ERR_OK,表示执行成功。

返回DM_ERR_FAILED,表示函数执行失败。

返回DM_ERR_OBTAIN_SERVICE,表示获取设备管理服务失败。

返回DM_ERR_OBTAIN_BUNDLE_NAME,表示获取bundleName失败。

返回ERR_INVALID_PARAMETER,表示参数localDeviceName是空指针或者*localDeviceName是非空指针。

OH_DeviceManager_GetLocalDeviceNameC()

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
int32_t OH_DeviceManager_GetLocalDeviceNameC(char **localDeviceName, unsigned int *len)

描述

获取本地设备显示名。

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

需要权限: ohos.permission.READ_LOCAL_DEVICE_NAME

起始版本: 26.0.0

参数:

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

返回:

展开
类型 说明
int32_t

返回执行的错误码。错误码定义详见DeviceManager_ErrorCode

返回ERR_OK,表示执行成功。

返回DM_ERR_FAILED,表示函数执行失败。

返回DM_ERR_OBTAIN_SERVICE,表示获取设备管理服务失败。

返回DM_ERR_OBTAIN_BUNDLE_NAME,表示获取bundleName失败。

返回ERR_INVALID_PARAMETER,表示参数localDeviceName是空指针或者*localDeviceName是非空指针或者len是空指针。

在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词