智能指针

对于操作原始的接口指针是比较麻烦的，需要我们自己控制引用记数、API 调用、异常处理。

于是 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对象，当这个大括号结束时，它就自动调用Release，把自己释
放。

        既然说到COM的智能指针，那就不能不提CoInitialize(Ex)这个函数，它用
来初始化COM库，并把当前线程加入到一个Department中。每一个CoInitialize都应有
一个CoUninitialize与之对应的，这也带来了问题。
        我的类里有些函数需返回一个IXMLDOMNodePtr，于是我把它做成一个成员变
量，专门用来返回，免得每次都在函数内构造；可是程序运行结束时会有内存错误；
而在函数内构造一个IXMLDOMNodePtr并将它返回却没问题。经检查发现，是因为
我没有在我的析构函数里调用CoUninitialize，而是在另一个函数CloseDocument里调用
它，导致在类对象销毁之前就已经调用了CoUninitialize，所以此时无论显式还是隐式
(自动)调用Release，都会因为所有的COM资源都已经被回收而失败。故有以下忠告：
*********************************************************************
忠告：请保证所有的智能指针在调用CoUninitialize之前都已经被释放，必
                要的话手工显式释放之。