异常和错误代码

OpenOffice.org 开发者指南

专业 UNO

< 上一章

下一章 >

• 简介
• API 概念

• 数据类型

• 简单类型
• Any 类型
• 接口
• 服务
• 结构
• 预定义值
• 序列
• 模块
• 异常
• Singleton

• 了解 API 引用

• UNO 概念

• UNO 进程间连接

• 在侦听模式启动 OpenOffice.org
• 导入 UNO 对象
• 进程间桥的属性
• 打开连接
• 创建桥
• 关闭连接
• 示例：连接识别客户机

• 服务管理器与组件上下文

• 服务管理器
• 组件上下文

• 使用 UNO 接口
• 属性
• 集合与容器
• 事件模型
• 异常处理
• UNO 对象的生存期

• acquire() 和 release()
• XComponent 接口
• XEventListener 接口的子接口
• 弱对象与弱引用
• C++ 对象与 Java 对象的生存期之间的差异

• 对象标识

• UNO 语言绑定

• Java 语言绑定

• 获取服务管理器
• Office UNO 组件的透明使用
• 处理接口
• 类型映射

• 序列类型的映射
• 枚举类型的映射
• 结构类型的映射
• 异常类型的映射
• 接口类型的映射
• UNOIDL 类型定义的映射
• 服务的映射
• Singleton 的映射
• UNO 值语义的不精确近似值

• C++ 语言绑定

• 建立进程间连接
• Office UNO 组件的透明使用
• 类型映射

• 结构类型的映射
• 接口类型的映射
• 序列类型的映射
• 服务的映射
• Singleton 的映射

• 使用弱引用
• C++ 中的异常处理

• OpenOffice.org Basic

• 处理 UNO 对象

• 实例化 UNO 服务
• 获取 UNO 对象的信息

• UNO 和 Basic 类型的映射

• 简单类型映射
• 序列和数组映射
• 结构映射
• 枚举和常数组映射

• 区分大小写
• 异常处理
• 侦听器

• Automation 桥

• 服务管理器组件
• 从 Automation 使用 UNO

• 调用函数并访问属性
• 返回值
• 类型的用法

• 从 UNO 中使用 Automation 对象
• 类型映射

• 默认映射

• 简单类型的映射
• hyper 和 Decimal 的映射
• 字符串的映射
• 接口和结构的映射
• 序列的映射
• 类型的映射

• 转换映射
• 客户机端转换
• 值对象
• 异常和错误代码

• 具有 UNO 接口的 Automation 对象
• DCOM
• 桥服务
• 不支持的 COM 功能

• CLI 语言绑定

• 语言绑定 DLL
• 类型映射

• 类型名称修饰
• 类型映射
• 附加结构

• 生存期管理和获取接口
• 编写客户机程序

• 重载问题
• 重要的接口和实现

< 上一页

下一页 >

UNO 接口函数通过抛出异常来指出错误。Automation 对象提供一种不同的错误机制。首先, IDispatch 接口描述在某些情况下返回的许多错误代码 (HRESULT)。其次,Invoke 函数接受一个参数,对象可以使用此参数提供描述性错误信息。参数是一种类型为 EXCEPINFO 的结构,桥用它来传达调用 UNO 接口函数后抛出的异常。如果 UNO 方法抛出异常,桥会使用以下值填充 EXCEPINFO::

 EXCEPINFO::wCode = 1001
 
 EXCEPINFO::bstrSource = "[automation bridge]"
 
 EXCEPINFO::bstrDescription = type name of the exceptions + the message of the exception (com::sun::star::uno::Exception::message )

并且返回的错误代码将为 DISP_E_EXCEPTION.

由于 automation 桥处理 Invoke 调用并且最终调用相应的 UNO 方法,因此,可以存在其他不是由 UNO 方法本身引起的错误。下表说明了这些错误及其原因。

HRESULT	原因
DISP_E_EXCEPTION	UNO 接口函数或属性访问函数抛出异常,并且调用程序没有提供 EXCEPINFO 参数。 桥错误。当客户机调用 Bridge_GetValueObject 时,无法创建 ValueObject。 桥错误。当客户机调用 Bridge_GetStruct时，无法创建 struct。 桥错误。当客户机调用 Bridge_CreateType 时,无法为 UNO 类型创建包装程序。 桥错误。Automation 对象包含一个不支持 XInvocation 接口的 UNO 对象。可能是 com.sun.star.script.Invocation 服务失败。 JScript 中 Array 对象作为 inout 参数传递,并且桥无法获取属性 “0”。 由于某种原因,转换 VARIANTARG(DISPPARAMS 结构)失败。 参数数目与 UNO 类型信息提供的数目不一致(仅当 DISPPARAMS 包含 VT_DISPATCH 时)。这是一个错误。应该返回 DISP_E_BADPARAMCOUNT。
DISP_E_NONAMEDARGS	调用程序提供“已命名参数”来调用 UNO 函数。
DISP_E_BADVARTYPE	转换 VARIANTARG 失败。 桥错误:调用程序提供一个 ValueObject,而且尝试获取值失败。这可能是一个错误。应该返回 DISP_E_EXCEPTION。 根据类型信息,不存在具有当前名称的成员。这是一个错误。应该返回 ,code>DISP_E_MEMBERNOTFOUND。 Bridge_CreateType 中的参数不是字符串或者无法转换成字符串。
DISP_E_BADPARAMCOUNT	给属性指定的是一个值,而调用程序提供空参数或多个参数。 调用程序没有提供 UNO 接口函数所需的参数数目。 当参数数目不是 1 时,调用 Bridge_CreateType。
DISP_E_MEMBERNOTFOUND	调用 Invoke 使用的 DISPID 不是由 GetIDsOfName 返回的值。 不存在当前调用 Invoke 时所用的接口函数(以及属性访问函数)。
DISP_E_TYPEMISMATCH	被调用的程序提供的参数类型不正确。
DISP_E_OVERFLOW	无法将一个参数强制转换成所需的类型。内部调用 XInvocation::invoke 导致抛出 CannotConvertException。字段 reason 具有值 OUT_OF_RANGE ,这表明给定值与目标类型的范围不匹配。
E_UNEXPECTED	[2] 执行 XInvocation::invoke 时 com.sun.star.script.CannotConvertException 的结果: FailReason::UNKNOWN。内部调用 XInvocation::invoke 导致抛出 com.sun.star.script.CannotConvertException。字段 reason 具有值 UNKNOWN,这表示某种未知错误状态。
E_POINTER	调用了 Bridge_GetValueObject 或 Bridge_GetStruct,但没有提供返回值的参数。
S_OK	正确。

IDispatch::GetIDsOfNames: 的返回值:

HRESULT	原因
E_POINTER	调用程序没有提供接收 DISPID 的参数。
DISP_E_UNKNOWNNAME	不存在给定名称的函数或属性。
S_OK	正确。

函数 IDispatch::GetTypeInfo 和 GetTypeInfoCount 返回 E_NOTIMPL。

从 UNO 调用 Automation 对象 时,以下 HRESULT 值将被转换成异常。请注意,已经确定 XInvocation::invoke() 的函数允许抛出的异常。

XInvocation::invoke() 抛出的异常及其对应的 HRESULT:

HRESULT	Exception
DISP_E_BADPARAMCOUNT	com.sun.star.lang.IllegalArgumentException
DISP_E_BADVARTYPE	com.sun.star.uno.RuntimeException
DISP_E_EXCEPTION	com.sun.star.reflection.InvocationTargetException
DISP_E_MEMBERNOTFOUND	com.sun.star.lang.IllegalArgumentException
DISP_E_NONAMEDARGS	com.sun.star.lang.IllegalArgumentException
DISP_E_OVERFLOW	com.sun.star.script.CannotConvertException, reason= FailReason::OUT_OF_RANGE
DISP_E_PARAMNOTFOUND	com.sun.star.lang.IllegalArgumentException
DISP_E_TYPEMISMATCH	com.sun.star.script.CannotConvertException, reason= FailReason::UNKNOWN
DISP_E_UNKNOWNINTERFACE	com.sun.star.uno.RuntimeException
DISP_E_UNKNOWNLCID	com.sun.star.uno.RuntimeException
DISP_E_PARAMNOTOPTIONAL	com.sun.star.script.CannotConvertException, reason= FailReason::NO_DEFAULT_AVAILABLE

XInvocation::invoke() 抛出的异常与 invoke() 相同:

HRESULT	Exception
DISP_E_BADPARAMCOUNT	com.sun.star.uno.RuntimeException
DISP_E_MEMBERNOTFOUND	com.sun.star.beans.UnknownPropertyException
DISP_E_NONAMEDARGS	com.sun.star.uno.RuntimeException

除了以下异常,XInvocation::getValue() 抛出的异常与 invoke() 相同:

HRESULT	Exception
DISP_E_BADPARAMCOUNT	com.sun.star.uno.RuntimeException
DISP_E_EXCEPTION	com.sun.star.uno.RuntimeException
DISP_E_MEMBERNOTFOUND	com.sun.star.beans.UnknownPropertyException
DISP_E_NONAMEDARGS	com.sun.star.uno.RuntimeException
DISP_E_OVERFLOW	com.sun.star.uno.RuntimeException
DISP_E_PARAMNOTFOUND	com.sun.star.uno.RuntimeException
DISP_E_TYPEMISMATCH	com.sun.star.uno.RuntimeException
DISP_E_PARAMNOTOPTIONAL	com.sun.star.uno.RuntimeException

Content on this page is licensed under the Public Documentation License (PDL).