COM组件设计与应用(十二)--错误与异常处理
来源:互联网 发布:宜家的床垫 知乎 编辑:程序博客网 时间:2024/05/23 12:33
下载源代码
一、前言
程序设计中,错误处理必不可少,而且通常要占用很大的篇幅。本回书着落在 COM 中的错误(异常)的处理方法。
在组件程序中,如果遇到错误,一般有两个方式进行处理。
二、简单返回
对于比较简单的错误,直接返回表示错误原因的 HRESULT。比如下面几个就是常见的错误值:
另外,你还可以返回自己构造 HRESULT 错误值。方法是使用宏 MAKE_HRESULT(sev,fac,code)
sev 严重程度
成功00成功,但有一些报告信息01警告10错误11fac 设备信息
FACILITY_AAF00000010010FACILITY_ACS00000010100FACILITY_BACKGROUNDCOPY00000100000FACILITY_CERT00000001011FACILITY_COMPLUS00000010001FACILITY_CONFIGURATION00000100001FACILITY_CONTROL00000001010FACILITY_DISPATCH00000000010FACILITY_DPLAY00000010101FACILITY_HTTP00000011001FACILITY_INTERNET00000001100FACILITY_ITF00000000100FACILITY_MEDIASERVER00000001101FACILITY_MSMQ00000001110FACILITY_NULL00000000000FACILITY_RPC00000000001FACILITY_SCARD00000010000FACILITY_SECURITY00000001001FACILITY_SETUPAPI00000001111FACILITY_SSPI00000001001FACILITY_STORAGE00000000011FACILITY_SXS00000010111FACILITY_UMI00000010110FACILITY_URT00000010011FACILITY_WIN3200000000111FACILITY_WINDOWS00000001000FACILITY_WINDOWS_CE00000011000code 唯一错误码
16位(bit) 你自己定义去吧 调用者得到返回的 HRESULT 值后,也可以使用宏 HRESULT_SEVERITY()、HRESULT_FACILITY()、HRESULT_CODE() 来取得sev错误程度、fac设备信息和 code 错误代码。
三、错误信息接口
既然 COM 是靠各种各样的接口来提供服务的,于是很自然地就会想到,是否有一个接口能够提供更丰富的错误信息报告那?答案是:ISupportErrorInfo。下面这段代码是使用 ISupportErrorInfo 的一般方法:
STDMETHODIMP Cxxx::fun()
{
... ... ... ...
CComQIPtr< ICreateErrorInfo> spCEI;
::CreateErrorInfo( &spCEI );
spCEI->SetGUID( IID_Ixxx );// 发生错误的接口IID
spCEI->SetSource( L"xxx.xxx" );// ProgID
// 如果你的组件同时提供了帮助文件,那么就可以:
spCEI->SetHelpContext( 0 );// 设置帮助文件的主题号
spCEI->SetHelpFile( L"xxx.hlp" );// 设置帮助文件的文件名
spCEI->SetDescription( L"错误描述信息" );
CComQIPtr < IErrorInfo > spErrInfo = spCEI;
if( spErrInfo )
::SetErrorInfo( 0, spErrInfo );// 这时调用者就可以得到错误信息了
return E_FAIL;
}
上面是原理性代码,在我们写的程序中,不用这么麻烦。因为 ATL 已经把上述的代码给我们包装成 CComCoClass::Error() 的6个重载函数了。如此,我们可以非常简单的改写为:
STDMETHODIMP Cxxx::fun()
{
... ... ... ...
return Error( L"错误描述信息" );
}
四、关于 try/catch
学习了 C++ 后,很多人都喜欢使用 try/catch 的异常处理结构。如果你使用 vc6.0的ATL,编译器默认是不支持异常处理的,编译后会报告“warning C4530: C++ exception handler used,but unwind semantics are not enabled. Specify -GX”,解决方法是手工加上编译开关:
图一、加上编译开关,支持C++的异常处理结构
在vc.net 2003 中,编译器默认是支持异常处理结构的,所以不用特别进行设置。如果想减小目标文件的尺寸,你也可以决定不使用 C++ 异常处理,那么在项目属性中
图二、在vc.net中修改是否支持C++异常结构的编译开关
五、客户端接收组件的错误信息
1、如果使用 API 方式调用组件,接收错误的方法是:
HRESULT hr = spXXX->fun()// 调用组件功能
if( FAILED( hr ) )// 如果发生了错误
{
CComQIPtr < ISupportErrorInfo > spSEI = spXXX;// 组件是否提供了 ISupportErrorInfo 接口?
if( spSEI )// 如果支持,那么
{
hr = spSEI->InterfaceSupportsErrorInfo( IID_Ixxx );// 是否支持 Ixxx 接口的错误处理?
if( SUCCEEDED( hr ) )
{// 支持,太好了。取出错误信息
CComQIPtr < IErrorInfo > spErrInfo;// 声明 IErrorInfo 接口
hr = ::GetErrorInfo( 0, &spErrInfo );// 取得接口
if( SUCCEEDED( hr ) )
{
CComBSTR bstrDes;
spErrInfo->GetDescription( &bstrDes );// 取得错误描述
......// 还可以取得其它的信息
}
}
}
}
2、如果使用 #import 等包装方式调用组件,接收错误的方法是:
try
{
......// 调用组件功能
}
catch( _com_error &e )
{
e.Description();// 取得错误描述信息
......// 还可以调用 _com_error 函数取得其它信息
}
六、编写支持错误处理的组件程序
非常简单,只要在增加 ATL 组件对象的时候选中 ISupportErrorInfo 即可。
图三、vc6.0 中,选中组件支持错误处理接口
图四、vc.net 2003 中,选中组件支持错误处理接口
七、小结
阅读文章后,请下载本回的示例程序。示例程序中演示了三种错误处理方法和三种接收错误的方法,同时程序中也有比较详细的注释。
- COM组件设计与应用(十二)--错误与异常处理
- COM组件设计与应用(十二)错误与异常处理
- COM 组件设计与应用(十二)——错误与异常处理
- COM组件设计与应用(十二)错误与异常处理
- COM组件设计与应用(十二)---错误与异常处理
- COM组件设计与应用(十二)错误与异常处理
- COM组件设计与应用(十二) 错误与异常处理
- COM组件设计与应用(十二)——错误与异常处理
- COM组件设计与应用12 - 错误与异常处理
- COM组件设计与应用12 - 错误与异常处理
- COM组件设计与应用(十二)
- COM组件设计与应用(十二)
- COM组件设计与应用(十二)
- COM组件设计与应用(十二)
- COM组件设计与应用(十二)(转载)
- COM 组件设计与应用(一)
- COM组件设计与应用(二)
- COM组件设计与应用(三)
- COM组件设计与应用(九)--IDispatch 接口 for vc6.0
- COM组件设计与应用(十)--IDispatch 接口 for vc.net
- 开题篇
- 这篇文章,让我在ACE的门前徘徊了很久。
- COM 组件设计与应用(十一)--IDispatch 及双接口的调用
- COM组件设计与应用(十二)--错误与异常处理
- COM组件设计与应用(十三)--事件和通知(VC6.0)
- COM组件设计与应用(十四)--事件和通知(vc.net)
- Java 实现Rsa 加密
- COM组件设计与应用(十五)--连接点(vc6.0)
- Symbian 创建播放器界面
- COM组件设计与应用(十六)--连接点(vc.net)
- COM 组件设计与应用(十七)——持续性
- 重头再来 不会再轻易放弃