四、关于组件调用
总的来说,调用组件程序大概有如下方法:
#include 方法 | IDL编译后,为方便C/C++程序员的使用,会产生xxx.h和xxx_i.c文件。我们真幸福,直接#include后就可以使用了 |
#import 方法 | 比较通用的方法,vc 会帮我们产生包装类,让我们的调用更方便 |
加载类型库包装类 方法 | 如果组件提供了 IDispatch 接口,用这个方法调用组件是最简单的啦。不过还没讲IDispatch,只能看以后的文章啦 |
加载ActiveX包装类 方法 | ActiveX 还没介绍呢,以后再说啦 |
下载示例程序后,请逐项浏览使用方法:
示例 | 方法 | 简要说明 |
1 | #include | 完全用最基本的 API 方式调用组件,使大家熟悉调用原理 |
2 | #include | 大部分使用 API 方式,使用 CComBSTR 简化对字符串的使用 |
3 | #include | 展示智能指针 CComPtr<> 的使用方法 |
4 | #include | 展示智能指针 CComPtr<> 和 CComQIPtr<> 混合的使用方法 |
5 | #include | 展示智能指针 CComQIPtr<> 的使用方法 |
6 | #include | 展示智能指针的释放方法 |
7 | #import | vc 包装的智能指针 IxxxPtr、_bstr_t、_variant_t 的使用方法和异常处理 |
8 | #import | import 后的命名空间的使用方法 |
示例程序中都写有注释,请读者仔细阅读并同时参考 MSDN 的函数说明。这里,我给大家介绍一下“智能指针”:
对于操作原始的接口指针是比较麻烦的,需要我们自己控制引用记数、API 调用、异常处理。于是 ATL 提供了2个智能指针的模板包装类,CComPtr<> 和 CComQIPtr<>,这两个类都在 <atlbase.h> 中声明。CComQIPtr<> 包含了 CComPtr<>的所有功能,因此我们可以完全用 CComQIPtr<> 来使用智能接口指针,唯一要说明的一点就是:CComQIPtr<> 由于使用了运算符的重载功能,它会自动帮我们调用QueryInterface()函数,因此 CComQIPtr<> 唯一的缺点就是不能定义 IUnknown * 指针。
// 智能指针 smart pointer,按照匈牙利命名法,一般以 sp 开头来表示变量类型
CComPtr < IUnknown > spUnk; // 正确
// 假设 IFun 是一个接口类型
CComPtr < IFun > spFun; // 正确
CComQIPtr < IFun > spFun; // 正确
CComQIPtr < IFun, &IID_IFun > spFun; // 正确
CComQIPtr < IUnknown > spUnk; // 错误!CComQIPtr不能定义IUnknown指针
给智能指针赋值的方法:
CComQIPtr < IFun > spFun; // 调用构造函数,还没有赋值,被包装的内部接口指针为 NULL
CComQIPtr < IFun > spFun( pOtherInterface ); // 调用构造函数,内部接口指针赋值为
// 通过 pOtherInterface 这个普通接口指针调用QueryInterface()得到的IFun接口指针
CComQIPtr < IFun > spFun( spOtherInterface ); // 调用构造函数,内部接口指针赋值为
// 通过 spOtherInterface 这个只能接口指针调用QueryInterface()得到的IFun接口指针
CComQIPtr < IFun > spFun ( pUnknown ); // 调用构造函数,由IUnknown的QueryInterface()得到IFun接口指针
CComQIPtr < IFun > spFun = pOtherInterface; // = 运算符重载,含义和上面一样
spFun = spOtherInterface; // 同上
spFun = pUnknown; // 同上
pUnknown->QueryInterface( IID_IFun, &sp ); // 也可以通过QueryInterface赋值
// 智能指针赋值后,可以用条件语句判断是否合法有效
if ( spFun ){} // 如果指针有效
if ( NULL != spFun ){} // 如果指针有效
if ( !spFun ){} // 如果指针无效
if ( NULL == spFun ){} // 如果指针无效
智能指针调用函数的方法:
spFun.CoCreateInstance(...); // 等价与 API 函数::CoCreateInstance(...)
spFun.QueryInterface(...); // 等价与 API 函数::QueryInterface()
spFun->Add(...); // 调用内部接口指针的接口函数
// 调用内部接口指针的QueryInterface()函数,其实效果和 spFun.QueryInterface(...) 一样
spFun->QueryInterface(...);
spFun.Release(); // 释放内部的接口指针,同时内部指针赋值为 NULL
spFun->Release(); // 错!!!一定不要这么使用。
// 因为这个调用并不把内部指针清空,那么析构的时候会被再次释放(释放了两次)
咳......不说了,不说了,大家多看书,多看MSND,多看示例程序吧。 写累了:-(