智能指针CComPtr 和 CComQIPtr
1 简介:
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(); // 错！！！一定不要这么使用。
// 因为这个调用并不把内部指针清空，那么析构的时候会被再次释放（释放了两次）
2 使用智能指针
使用智能指针的好处是不需要我们去显示的释放接口指针
首先要加载atlbase.h文件
＃i nclude “atlbase.h”
＃i nclude “xxx.h”
＃i nclude “xxx_i.c”
CComPtr<IUnknown> pIUnknown; // 定义 IUnknown 的智能指针
CComPtr<IObj1> pObj1; // 定义 IObj1 的智能指针
HRESULT hr;
try
{
//可以用CLSID,也可以用PROGID启动组件
hr = pIUnknown.CoCreateInstance(CLSID_Obj1);
if(FAILED(hr))
{
throw(_T("启动组件出错"));
}
hr = pIUnknown.QueryInterface(&pObj1);
if(FAILED(hr))
{
throw(_T("Query接口错误"));
}
long pVal;
hr = pObj1->add(147,258,&pVal);
if(FALSE(hr))
{
throw(_T("加载函数出错"));
}
CString sMsg;
sMsg.Format( _T("147 + 258 = %ld"), pVal );
AfxMessageBox( sMsg );
}
catch (LPCTSTR lpstr)
{
AfxMessageBox(lpstr);
}
3 CComQIPtr 和 CComPtr 的区别
template< class T, const IID* piid = &__uuidof(T) > class CComQIPtr: public CComPtr<T>
除了构造函数以外，这两个模板提供的功能一模一样。
一般来说，CComQIPtr提供了几乎所有CComPtr的功能，但是有唯一一个例外，CComQIPtr<IUnknown>是不合法的，template<class T, const IID* piid = &__uuidof(T)>class CComQIPtr 的构造符重复定义。
必须写成CComQIPtr<IUnknown, &IID_IUnknown>。 (#add 相比于 CComQIPtr< IUnknown > spUnk; // 错误！CComQIPtr不能定义IUnknown指针 )
除此之外，其他CComPtr都可以用CComQIPtr代替。