智能指针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代替。