智能指针 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 );    // 调用构造函数，由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);

       }