三、使用ATL简化编程
使用原生的COM接口的话,需要自己管理生存期,上边的程序很简单并无大碍,但稍微复杂一点的程序便十分棘手,还容易出错。为了减少编程人员的负担,使COM编程更加方便和可靠,微软的ATL(活动模板库)为我们准备了一个COM接口的智能指针:CComPtr<T>。
CComPtr<T>的主要作用是容纳接口的指针T*。CComPtr<T>在赋值时会自动进行Release和AddRef,在出作用域时自动进行Release,实现了自动管理生命周期。它同时重载了模板化赋值运算符,自动调用QueryInterface。还简化了CoCreateInstance等函数的调用。
首先,使用ATL要使用C++编译器编译,并且包含头文件atlbase.h:
#include <atlbase.h>
CComPtr<T>的使用很简单。建立一个空指针的操作如下:
CComPtr<ISpVoice> pISpVoice; // 自动设为NULL
在CComPtr<T>上建立新实例(注意是点运算符,不是箭头):
hr = XXXXXXXXXXXXCreateInstance(CLSID_SpVoice); // 省略了后两个参数:pUnkOuter=NULL, dwClsContext=CLSCTX_ALL
调用成员函数(箭头运算符):
hr = pISpVoice->Speak(L"电脑在说话!", SPF_DEFAULT, NULL);
赋值:
pISpVoice2 = pISpVoice; // 自动调用pISpVoice2的Release和pISpVoice的AddRef
转换接口类型:
CComPtr<IUnknown> pUnk = pISpVoice; // 自动调用QueryInterface,失败则返回NULL
取地址:
pUnk = NULL; // 作为输出(out)参数必须先置为NULL
pISpVoice.QueryInterface(&pUnk); // &运算符获得pUnk.p成员变量的地址
CComPtr<T>在离开作用域时会自动释放。但有时需要手动释放,比如需要再次调用CoCreateInstance时。手动释放有两种方法:
1.赋值NULL
pISpVoice = NULL; // 自动调用Release
2.调用.Release(),注意不是->Release(),它会同时将值设为NULL,防止悬空指针产生
XXXXXXXXXXXXlease(); // 调用Release,同时设为NULL
有了CComPtr<T>,我们的程序可以简化为这样。可以看到,我们已经不再需要手工释放COM组件了,CoCreateInstance的调用也大为简化:
#include <stdio.h>
#include <stdlib.h>
#include <windows.h> // 使用COM组件需要包含windows.h
#include <sapi.h> // 使用ISpVoice语音组件需要包含sapi.h
#include <atlbase.h> // 使用CComPtr<t>需要包含atlbase.h
#define ValidateHR(hr) \
if (FAILED(hr)) { \
printf("HRESULT错误:%p,在%s第%d行\n", hr, __FILE__, __LINE__); \
exit(1); \
}
int main()
{
HRESULT hr = CoInitialize(0); // 初始化COM环境,参数保留,必须为0
ValidateHR(hr);
{
// 建立ISpVoice接口实例(组件ID为CLSID_SpVoice)
CComPtr<ispvoice> pISpVoice;
hr = pISpVoice.CoCreateInstance(CLSID_SpVoice); // 点运算符。省略了后两个参数:NULL, CLSCTX_ALL
ValidateHR(hr);
// 调用ISpVoice的Speak成员函数
hr = pISpVoice->Speak(L"电脑在说话!", SPF_DEFAULT, NULL);
ValidateHR(hr);
} // pISpVoice在作用域边界会自动释放
CoUninitialize(); // 卸载COM环境
return 0;
}</ispvoice></t></atlbase.h></sapi.h></windows.h></stdlib.h></stdio.h>
为了方便起见,以后的程序均使用CComPtr<IMyInterface>,不再使用IMyInterface*。