智能指针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 );    // 调用构造函数,由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();      // 错!!!一定不要这么使用。

   // 因为这个调用并不把内部指针清空,那么析构的时候会被再次释放(释放了两次)

 

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代替。

 

你可能感兴趣的:(com)