智能客服
你问我答，随时在线为你解决问题
本模块首批接口从API version 21 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
本模块接口仅可在Stage模型下使用。
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
全部文档
指南
API
开放能力API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
@ohos.app.ability.CompletionHandlerForAbilityStartCallback (拉起应用结果回调的操作类)
Phone21+PC/2in121+Tablet21+TV21+Wearable21+
更新时间: 2026-08-29 09:41
本文导读
CompletionHandlerForAbilityStartCallback作为AbilityStartCallback的可选参数，用于返回垂域面板拉起指定类型的Ability组件的回调结果。
说明
导入模块
收起
自动换行
深色代码主题
复制
- import { CompletionHandlerForAbilityStartCallback } from '@kit.AbilityKit';
CompletionHandlerForAbilityStartCallback
Phone21+PC/2in121+Tablet21+TV21+Wearable21+
CompletionHandlerForAbilityStartCallback提供了onRequestSuccess和onRequestFailure两个回调函数属性，分别在拉起指定类型的Ability组件成功和失败时回调。
属性
系统能力：SystemCapability.Ability.AbilityRuntime.Core
展开
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| onRequestSuccess | OnRequestSuccessFn | 否 | 是 | 拉起指定类型的Ability组件成功时的回调函数。 元服务API：从API version 21开始，该接口支持在元服务中使用。 |
| onRequestFailure | OnRequestFailureFn | 否 | 是 | 拉起指定类型的Ability组件失败时的回调函数。 元服务API：从API version 21开始，该接口支持在元服务中使用。 |
OnRequestSuccessFn
Phone21+PC/2in121+Tablet21+TV21+Wearable21+
type OnRequestSuccessFn = (name: string) => void
拉起指定类型的Ability组件成功时的回调函数类型。
元服务API：从API version 21开始，该接口支持在元服务中使用。
系统能力：SystemCapability.Ability.AbilityRuntime.Core
参数：
展开
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 被拉起Ability组件或系统操作的名称。 Ability组件名称采用'[bundleName]#[moduleName]#[abilityName]'格式拼接。 |
示例：
OnRequestFailureFn
Phone21+PC/2in121+Tablet21+TV21+Wearable21+
type OnRequestFailureFn = (name: string, failureCode: AbilityStartFailureCode, failureMessage: string) => void
拉起指定类型的Ability组件失败时的回调函数类型。
元服务API：从API version 21开始，该接口支持在元服务中使用。
系统能力：SystemCapability.Ability.AbilityRuntime.Core
参数：
展开
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 被拉起Ability组件或系统操作的名称。 Ability组件名称采用'[bundleName]#[moduleName]#[abilityName]'格式拼接。如果用户自动取消拉起，name为空。 |
| failureCode | AbilityStartFailureCode | 是 | 失败原因的错误码。 |
| failureMessage | string | 是 | 失败原因的描述。 |
示例：
收起
自动换行
深色代码主题
复制
- import { AbilityStartFailureCode, common, CompletionHandlerForAbilityStartCallback } from '@kit.AbilityKit';
- import { BusinessError } from '@kit.BasicServicesKit';
-
- @Entry
- @Component
- struct Index {
- @State message: string = 'Hello World';
- context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
-
- completionHandler: CompletionHandlerForAbilityStartCallback = {
- onRequestSuccess: (name: string) => {
- console.info(`testTag onRequestSuccess name` + name);
- },
- onRequestFailure: (name: string, failureCode: AbilityStartFailureCode, failureMessage: string) => {
- console.info(`testTag onRequestFailure name: ` + name + `, failureCode:` + failureCode + `, failureMessage:` +
- failureMessage);
- }
- };
- abilityStartCallback: common.AbilityStartCallback = {
- onError: (code: number, name: string, message: string) => {
- console.error(`testTag code:` + code + `name:` + name + `message:` + message);
- },
- onResult: (abilityResult: common.AbilityResult) => {
- console.info(`testTag resultCode:` + abilityResult.resultCode + `bundleName:` + abilityResult.want?.bundleName);
- },
- completionHandler: this.completionHandler,
- };
-
- build() {
- Column({ space: 10 }) {
- Button('test')
- .type(ButtonType.Capsule)
- .offset({ x: 0, y: 60 })
- .width('80%')
- .type(ButtonType.Capsule)
- .margin({ top: 10 })
- .onClick(() => {
- let wantParam: Record<string, Object> = {
- 'time': '2023-10-23 20:45'
- };
- this.context.startAbilityByType("share", wantParam, this.abilityStartCallback).then(() => {
- console.info(`startAbilityByType success`);
- }).catch((err: BusinessError) => {
- console.error(`Failed startAbilityByType. Code: ${JSON.stringify(err.code)}, message: ${JSON.stringify(err.message)}`);
- });
- })
- }
- }
- }
AbilityStartFailureCode
Phone21+PC/2in121+Tablet21+TV21+Wearable21+
拉起指定类型的Ability组件失败的特定错误码。
元服务API：从API version 21开始，该接口支持在元服务中使用。
系统能力：SystemCapability.Ability.AbilityRuntime.Core
展开
| 名称 | 值 | 说明 |
|---|---|---|
| FAILURE_CODE_SYSTEM_MALFUNCTION | 0 | 表示由于系统错误（如跳转弹框崩溃）而无法拉起Ability组件。 |
| FAILURE_CODE_USER_CANCEL | 1 | 用户取消。 |
华为开发者联盟 版权所有 ©2026
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词