输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
API参考
高级筛选
API version全部版本
设备全部
元服务API集不筛选
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
API参考应用框架Ability Kit（程序框架服务）C API头文件ability_resource_info.h

ability_resource_info.h

更新时间: 2026-06-13 03:51
本文导读
展开章节

概述

PhonePC/2in1TabletTVWearable

提供组件资源信息的接口，用于获取组件的以下信息：包名、模块名、组件名、图标、分身索引、是否为默认应用等。

引用文件： <bundle/ability_resource_info.h>

库： libbundle_ndk.z.so

系统能力： SystemCapability.BundleManager.BundleFramework.Core

起始版本： 21

相关模块： Native_Bundle

汇总

PhonePC/2in1TabletTVWearable

结构体

PhonePC/2in1TabletTVWearable
展开
名称 typedef关键字 描述
OH_NativeBundle_AbilityResourceInfo OH_NativeBundle_AbilityResourceInfo 表示组件资源信息。

函数

PhonePC/2in1TabletTVWearable
展开
名称 描述
BundleManager_ErrorCode OH_NativeBundle_GetBundleName(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, char** bundleName) 获取组件的包名。在使用该接口之后，为了防止内存泄漏，需要手动释放接口返回的指针。
BundleManager_ErrorCode OH_NativeBundle_GetModuleName(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, char** moduleName) 获取组件的模块名。在使用该接口之后，为了防止内存泄漏，需要手动释放接口返回的指针。
BundleManager_ErrorCode OH_NativeBundle_GetAbilityName(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, char** abilityName) 获取组件名。在使用该接口之后，为了防止内存泄漏，需要手动释放接口返回的指针。
BundleManager_ErrorCode OH_NativeBundle_GetDrawableDescriptor(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, ArkUI_DrawableDescriptor** drawableIcon) 获取组件图标资源对应的DrawableDescriptor对象。在使用该接口之后，为了防止内存泄漏，需要手动调用OH_AbilityResourceInfo_Destroy释放接口返回的指针。
BundleManager_ErrorCode OH_NativeBundle_GetLabel(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, char** label) 获取组件的应用名称。在使用该接口之后，为了防止内存泄漏，需要手动释放接口返回的指针。
BundleManager_ErrorCode OH_NativeBundle_GetAppIndex(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, int* appIndex) 获取组件的分身索引。
BundleManager_ErrorCode OH_NativeBundle_CheckDefaultApp(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, bool* isDefault) 查询组件所属的应用是否为默认应用。
BundleManager_ErrorCode OH_AbilityResourceInfo_Destroy(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, size_t count) 该接口应在对OH_NativeBundle_GetAbilityResourceInfo的使用完成后调用，以避免内存泄漏。
int OH_NativeBundle_GetSize() 获取单个结构体OH_NativeBundle_AbilityResourceInfo的大小。

函数说明

PhonePC/2in1TabletTVWearable

OH_NativeBundle_GetBundleName()

PhonePC/2in1TabletTVWearable
收起
自动换行
深色代码主题
复制
  1. BundleManager_ErrorCode OH_NativeBundle_GetBundleName(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, char** bundleName)

描述

获取组件的包名。在使用该接口之后，为了防止内存泄漏，需要手动释放接口返回的指针。

起始版本： 21

参数：

展开
参数项 描述
OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo 指定组件资源信息。
char** bundleName 获取的包名。

返回：

展开
类型 说明
BundleManager_ErrorCode

执行结果。

如果获取成功，返回BUNDLE_MANAGER_ERROR_CODE_NO_ERROR。

如果获取失败，返回BUNDLE_MANAGER_ERROR_CODE_PARAM_INVALID，这是由于abilityResourceInfo为空指针所致。

OH_NativeBundle_GetModuleName()

PhonePC/2in1TabletTVWearable
收起
自动换行
深色代码主题
复制
  1. BundleManager_ErrorCode OH_NativeBundle_GetModuleName(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, char** moduleName)

描述

获取组件的模块名。在使用该接口之后，为了防止内存泄漏，需要手动释放接口返回的指针。

起始版本： 21

参数：

展开
参数项 描述
OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo 指定组件资源信息。
char** moduleName 获取的模块名。

返回：

展开
类型 说明
BundleManager_ErrorCode

执行结果。

如果获取成功，返回BUNDLE_MANAGER_ERROR_CODE_NO_ERROR。

如果获取失败，返回BUNDLE_MANAGER_ERROR_CODE_PARAM_INVALID，这是由于abilityResourceInfo为空指针所致。

OH_NativeBundle_GetAbilityName()

PhonePC/2in1TabletTVWearable
收起
自动换行
深色代码主题
复制
  1. BundleManager_ErrorCode OH_NativeBundle_GetAbilityName(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, char** abilityName)

描述

获取组件名。在使用该接口之后，为了防止内存泄漏，需要手动释放接口返回的指针。

起始版本： 21

参数：

展开
参数项 描述
OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo 指定组件资源信息。
char** abilityName 获取的组件名。

返回：

展开
类型 说明
BundleManager_ErrorCode

执行结果。

如果获取成功，返回BUNDLE_MANAGER_ERROR_CODE_NO_ERROR。

如果获取失败，返回BUNDLE_MANAGER_ERROR_CODE_PARAM_INVALID，这是由于abilityResourceInfo为空指针所致。

OH_NativeBundle_GetDrawableDescriptor()

PhonePC/2in1TabletTVWearable
收起
自动换行
深色代码主题
复制
  1. BundleManager_ErrorCode OH_NativeBundle_GetDrawableDescriptor(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, ArkUI_DrawableDescriptor** drawableIcon)

描述

获取组件图标资源对应的DrawableDescriptor对象。在使用该接口之后，为了防止内存泄漏，需要手动调用OH_AbilityResourceInfo_Destroy释放接口返回的指针。

起始版本： 21

参数：

展开
参数项 描述
OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo 指定组件资源信息。
ArkUI_DrawableDescriptor** drawableIcon 组件图标资源对应的DrawableDescriptor对象。

返回：

展开
类型 说明
BundleManager_ErrorCode

执行结果。

如果获取成功，返回BUNDLE_MANAGER_ERROR_CODE_NO_ERROR。

如果获取失败，返回BUNDLE_MANAGER_ERROR_CODE_PARAM_INVALID，这是由于abilityResourceInfo为空指针所致。

OH_NativeBundle_GetLabel()

PhonePC/2in1TabletTVWearable
收起
自动换行
深色代码主题
复制
  1. BundleManager_ErrorCode OH_NativeBundle_GetLabel(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, char** label)

描述

获取组件的应用名称。在使用该接口之后，为了防止内存泄漏，需要手动释放接口返回的指针。

起始版本： 21

参数：

展开
参数项 描述
OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo 指定组件资源信息。
char** label 获取的应用名称。

返回：

展开
类型 说明
BundleManager_ErrorCode

执行结果。

如果获取成功，返回BUNDLE_MANAGER_ERROR_CODE_NO_ERROR。

如果获取失败，返回BUNDLE_MANAGER_ERROR_CODE_PARAM_INVALID，这是由于abilityResourceInfo为空指针所致。

OH_NativeBundle_GetAppIndex()

PhonePC/2in1TabletTVWearable
收起
自动换行
深色代码主题
复制
  1. BundleManager_ErrorCode OH_NativeBundle_GetAppIndex(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, int* appIndex)

描述

获取组件的分身索引。

起始版本： 21

参数：

展开
参数项 描述
OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo 指定组件资源信息。
int* appIndex 获取的分身索引。

返回：

展开
类型 说明
BundleManager_ErrorCode

执行结果。

如果获取成功，返回BUNDLE_MANAGER_ERROR_CODE_NO_ERROR。

如果获取失败，返回BUNDLE_MANAGER_ERROR_CODE_PARAM_INVALID，这是由于abilityResourceInfo为空指针所致。

OH_NativeBundle_CheckDefaultApp()

PhonePC/2in1TabletTVWearable
收起
自动换行
深色代码主题
复制
  1. BundleManager_ErrorCode OH_NativeBundle_CheckDefaultApp(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, bool* isDefault)

描述

查询组件所属的应用是否为默认应用。

起始版本： 21

参数：

展开
参数项 描述
OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo 指定组件资源信息。
bool* isDefault 组件所属的应用是否为默认应用，默认应用是指用户为特定文件类型或操作设定的首选应用。取值true为默认应用，false为非默认应用。

返回：

展开
类型 说明
BundleManager_ErrorCode

执行结果。

如果查询成功，返回BUNDLE_MANAGER_ERROR_CODE_NO_ERROR。

如果查询失败，返回BUNDLE_MANAGER_ERROR_CODE_PARAM_INVALID，这是由于abilityResourceInfo为空指针所致。

OH_AbilityResourceInfo_Destroy()

PhonePC/2in1TabletTVWearable
收起
自动换行
深色代码主题
复制
  1. BundleManager_ErrorCode OH_AbilityResourceInfo_Destroy(OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo, size_t count)

描述

释放组件资源信息的内存。

起始版本： 21

参数：

展开
参数项 描述
OH_NativeBundle_AbilityResourceInfo* abilityResourceInfo 要释放的组件资源信息。
size_t count 表示组件资源信息数组的大小。

返回：

展开
类型 说明
BundleManager_ErrorCode

执行结果。

如果释放成功，返回BUNDLE_MANAGER_ERROR_CODE_NO_ERROR。

如果释放失败，返回BUNDLE_MANAGER_ERROR_CODE_PARAM_INVALID，这是由于abilityResourceInfo为空指针所致。

OH_NativeBundle_GetSize()

PhonePC/2in1TabletTVWearable
收起
自动换行
深色代码主题
复制
  1. int OH_NativeBundle_GetSize()

描述

获取单个结构体OH_NativeBundle_AbilityResourceInfo的大小。

起始版本： 21

返回：

展开
类型 说明
int 返回单个结构体OH_NativeBundle_AbilityResourceInfo的大小。
want.h
bundle_manager_common.h
相关推荐
文档OH_NativeBundle_AbilityResourceInfo
文档native_interface_bundle.h
文档@ohos.bundle (Bundle模块)
文档context.h
文档application_context.h
文档AbilityInfo
文档@ohos.bundle.bundleManager (应用程序包管理模块)
文档HapModuleInfo
文档@ohos.bundle.launcherBundleManager (launcherBundleManager模块)
文档@ohos.app.ability.abilityManager (Ability信息管理)
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 API参考 中进行搜索
请输入您想要搜索的关键词