CComPtr智能指针
作者:admin 日期:2011-08-05
前几天在学C#,尝试做一个浏览器。本来C#里面好像有一个WebBrowser类吧,可以实现浏览器的一般功能了。甚至DOM也可以操纵了。但最后还是碰到一个问题,新窗口打开的问题。最后折腾得没办法,只能用到了IWebBrowser2这个com组件。有这个东西,新窗口打开解决了之后,还忙了好久...原因就在于我对这个com组件,没什么了解。
今天就很想把这个com搞搞清楚。但com可能真的是一个比较庞大的概念吧,可能是比较深邃...没入门的我网上找来找去找资料,找了还看不懂...
无奈最后下到一本《COM编程内幕》看了半本,算是有所收获,写了个超级简单,最最简单的COM组件,用asp调用成功了。
现在把,找来的一些资料放在这博客里了。
COM接口指针很危险,因为使用过程中需要每一个使用者都要严格并且正确的AddRef和Release,一旦出现问题,就会造成对象不能被正常释放,或者对象被重复删除,造成程序崩溃。所以使用COM接口,必须小心翼翼才行。 CComPtr被称为智能指针,是ATL提供的一个模版类,能够从语法上自动完成AddRef和Release。(源代码在atlbase.h中) CComPtr用法
但是,即使所有的代码中,都正确的AddRef和Release,也不一定能保证万无一失,例如:
void SomeApp( IHello * pHello )
{
IHello* pCopy = pHello;
pCopy->AddRef();
OtherApp();
pCopy->Hello();
pCopy->Release();
}
看起来好像无懈可击,但是假设OtherApp中抛出了异常,那么pCopy->Release不就被跳过去了吗?
幸好,所有的问题都从简单到复杂,再从复杂到简单的,因为我们有CComPtr!
CComPtr的用法很简单,以IHello*为例,将程序中所有接口指针类型(除了参数),都使用CComPtr<IHello> 代替即可。即程序中除了参数之外,再也不要使用IHello*,全部以CComPtr<IHello>代替。
CComPtr的用法和普通COM指针几乎一样,另外使用中有以下几点需要注意。
1. CComPtr已经保证了AddRef和Release的正确调用,所以不需要,也不能够再调用AddRef和Release。
2. 如果要释放一个智能指针,直接给它赋NULL值即可。
3. CComPtr本身析构的时候会释放COM指针。
4. 当对CComPtr使用&运算符(取指针地址)的时候,要确保CComPtr为NUL。(因为通过CComPtr的地址对CComPtr赋值时,不会自动调用AddRef,若不为NULL,则前面的指针不能释放,CComPtr会使用assert报警)
以刚才的程序为例:
void SomeApp( IHello * pHello )
{
CComPtr<IHello> pCopy = pHello;
OtherApp();
pCopy->Hello();
}
由于pCopy是一个局部的对象,所以即使OtherApp()抛出异常,pCopy也会被析构,指针能够被释放。
如果不想在程序临近发布前,还因为COM指针的引用计数造成崩溃的话,就牢记这一点吧:程序中除了参数之外,不要直接使用COM指针类型,一定要全部以CComPtr<IXXX>代替。
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(); // 错!!!一定不要这么使用。 // 因为这个调用并不把内部指针清空,那么析构的时候会被再次释放(释放了两次) 使用智能指针的好处是不需要我们去显示的释放接口指针 首先要加载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); } template <class T> class CComPtr { public: typedef T _PtrClass; CComPtr() { p=NULL; } CComPtr(T* lp) { if ((p = lp) != NULL) p->AddRef(); } CComPtr(const CComPtr<T>& lp) { if ((p = lp.p) != NULL) p->AddRef(); } ~CComPtr() { if (p) p->Release(); } void Release() { IUnknown* pTemp = p; if (pTemp)2 使用智能指针
3 CComPtr的代码