COM笔记-关于HRESULT

HRESULT

HRESULT（Here's the RESULT）值分成32位值，

 

HRESULT值中16到30这15个比特位包含的是设备代码。设备代码标识的是可以返回HRESULT返回代码的操作系统部分。由于Windows操作系统是由Microsoft开发的。因此它保留有定义设备代码的权力。

 

HRESULT值的查找

获取与某个特定HRESULT值相应的错误消息并将其显示出来的方法。以显示标准COM（以及AcitveX）错误消息，可以使用Win32 API中的FormatMessage函数

 

HRESULT值的使用

注意：

成功的代码有多个，失败的代码也有多个

失败代码可能会发生变化。

1多状态代码

一个函数在各种情况下返回的状态代码通常将包含多个成功代码及多个失败代码。这就是我们为什么要使用SUCCEEDED及FAILED宏的原因。一般不能直接将HRESULT值同某个成功代码（如S_OK）进行比较以决定某个函数是否成功。

 

2错误可能会发生变化

在编写好客户程序之后，其他人可能会定义新的HRESULT错误代码，客户程序也可能会遇到相应的错误。

 

用户自己代码的定义

关于定义自己的HRESULT的一般性规则：

1、不要将0x0000及0x01ff范围内的值作为返回代码。这些值是为COM所定义的FACILITY_ITF代码而保留的。只有遵循这一规则，才不致使用户自己定义的代码同COM所定义的代码相混淆。

2、不要传播FACILITY__ITF错误代码。

3、尽可能地使用通用的COM成功及失败代码。

 

可以使用MAKE_HRESULT宏来定义一个HRESULT值。此宏可以根据所提供的严重级别、设备代码及返回代码生成一个HRESULT值。

 

MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 100);

MAKE_HRESULT(SEVERITY_SUCCESS,, FACILITY_ITF, 101);

对于自己定义的返回代码的命名，有一个约定 是在其名称前面加上组件或接口的名称。

如：

AIRPLANE_E_LANDINGWITHGEARUP

HELICOPTER_S_ROTORRPMGREEN

本文地址：http://www.cnblogs.com/fangyukuan/archive/2010/06/10/1755874.html