CComPtr智能指针

前几天在学C#,尝试做一个浏览器。本来C#里面好像有一个WebBrowser类吧,可以实现浏览器的一般功能了。甚至DOM也可以操纵了。但最后还是碰到一个问题,新窗口打开的问题。最后折腾得没办法,只能用到了IWebBrowser2这个com组件。有这个东西,新窗口打开解决了之后,还忙了好久...原因就在于我对这个com组件,没什么了解。

今天就很想把这个com搞搞清楚。但com可能真的是一个比较庞大的概念吧,可能是比较深邃...没入门的我网上找来找去找资料,找了还看不懂...

无奈最后下到一本《COM编程内幕》看了半本,算是有所收获,写了个超级简单,最最简单的COM组件,用asp调用成功了。

现在把,找来的一些资料放在这博客里了。

CComPtr用法

COM接口指针很危险,因为使用过程中需要每一个使用者都要严格并且正确的AddRef和Release,一旦出现问题,就会造成对象不能被正常释放,或者对象被重复删除,造成程序崩溃。所以使用COM接口,必须小心翼翼才行。
但是,即使所有的代码中,都正确的AddRef和Release,也不一定能保证万无一失,例如:
void SomeApp( IHello * pHello )
{
IHello* pCopy = pHello;
pCopy->AddRef(); 
OtherApp();
pCopy->Hello();
pCopy->Release();
}
看起来好像无懈可击,但是假设OtherApp中抛出了异常,那么pCopy->Release不就被跳过去了吗?
幸好,所有的问题都从简单到复杂,再从复杂到简单的,因为我们有CComPtr!

CComPtr被称为智能指针,是ATL提供的一个模版类,能够从语法上自动完成AddRef和Release。(源代码在atlbase.h中)
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>代替。

 

智能指针CComPtr 和 CComQIPtr

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 );    // 调用构造函数,由IUnknownQueryInterface()得到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 );

              AfxMessageBoxsMsg );

       }

       catch (LPCTSTR lpstr)

       {

              AfxMessageBox(lpstr);

       }

3    CComPtr的代码

template <class T>

class CComPtr

{

public:

       typedef T _PtrClass;

       CComPtr()

       {

              p=NULL;

       }

       CComPtr(Tlp)

       {

              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()

       {

              IUnknownpTemp = p;

              if (pTemp)



文章来自: 本站原创
Tags:
评论: 0 | 查看次数: 13618