CComPtr 和 CComQIPtr

来源:互联网 发布:提分宝典的真实性知乎 编辑:程序博客网 时间:2024/04/29 07:04
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();      // 错!!!一定不要这么使用。
   // 因为这个调用并不把内部指针清空,那么析构的时候会被再次释放(释放了两次)
 
CComPtr和CComQIPtr

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



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


原创粉丝点击