ATL 提供了2个智能指针的模板包装类CComPtr 和 CComQIPtr

来源:互联网 发布:照片无缝拼接软件 编辑:程序博客网 时间:2024/03/29 14:55

 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();      // 错!!!一定不要这么使用。

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

------------------------------------------------------------

CComPtr和CComQIPtr

CComPtr<IWebBrowser2> m_spWebBrowser2;
IUnknown *pUnknown;
pUnknown->QueryInterface(&m_spWebBrowser2);

CComQIPtr<IWebBrowser2, &IID_IWebBrowser2> m_spWebBrowser2;
IUnknown *pUnknown;
m_spWebBrowser2 = pUnknown;