2020-10-19

CComPtr和CComQIPtr

CComPtr和CComQIPtr是智能接口指针类，它们在销毁的时候，不需要手动去释放接口指针，在赋值的时候，也不需要手动的AddRef,在出现异常的时候，会自动处理异常，而不需要额外的异常处理代码。

 

     CComPtr和CComQIPtr的不同的地方：CComPtr只能创建固定的特定的接口指针实例。而CComQIPtr不但实现了CComPtr的所有的功能，而且当我们把一个不同类型的接口指针赋值给CComQIPtr的时候，CComQIPtr会自动的调用接口指针的QueryInterface接口，来获得对应的正确的接口指针。

 

     （1） 构造函数

            第一个参数为智能接口指针的类型，第二个参数为 智能指针的接口ID。

 

            CComPtr<IUnknown> punk;

 

            //下面三个例子完全相同

            CComPtr<IXXX> pno;

            CComPtr<IXXX,&__uuidof(IXXX)> pno;

            CComPtr<IXXX,&IID_IXXX> pno;

 

      CComQIPtr可以用任何一个类型的接口指针初始化，如果初始化的值与CComQIPtr的类型相同，那么构造函数简单调用 指针的AddRef,但是，如果类型不同的话，它会先调用指针的QueryInterface来获得相同的类型的接口指针，当QueryInterface失败的话，内部指针会被设置为NULL。

           所有下面的代码，可以用来检测是否转换成功：

void  Func(IUnknown * punk)  
  
{  
  
      CComQIPtr<IXXX> pno(punk);  
  
      if(pno)  
  
     {  
  
        //正确转换  
  
        pno->doSomething();  
  
     }  
  
}  

2)赋值

          赋值的时候，发生下面三件事：

          111.  如果当前指针不为空，那么释放当前指针

          222.   如果源指针不为空，那么AddRef

          333.   将当前指针设置为源指针

     oprator =  可以让我们把任何一个CComPtr赋值给CComQIPtr对象，如果有必要就会调用QueryInterface .

          例如：

CComQIPtr<IFoo>   fooPtr;  
  
CComQIPtr<IBar>    barPtr;  
  
  
  
barPtr=fooPtr; 

    (3)  CoCreateInstance方法

         CComPtr提供了一个实例化对象的方法

 

          HRESULT   CoCreateInstance(REFCLSID  rclsid,LPUNKNOWN  pUnkOuter=NULL, DWORD dwClsCOntext=CLSCTX_ALL);

 

 

          HRESULT   CoCreateInstance(LPCOLESTR szProgID, LPUNKNOSWN

pUnkOuter=NULL, DWORD  dwClsContxt=CLSCTX_ALL);

 

         后两个参数不管，第一个参数要不传入CLSID,要不传入字符串形式的progID.

        

        例子代码如下：

CComPtr<IXXX> ptr;  
  
HRESULT  hr=ptr.CoCreateInstance(__uuidof(IXXX));  

(4)  operator *()

          当对CComPtr解除指针的引用时，跟普通的指针一样，返回一个内部指针类型的引用。

 

     (5)   operator &()

 

          获取智能指针对象的地址，实际上也是返回内部指针的地址，跟普通指针一样。

 

     (6)  在调用ComUninitialize方法前，需要手动释放所有的全局或者静态变量。

 

            如何手动释放呢：

            111.设置指针指向NULL

            222.调用Release方法，注意是要调用智能指针的Release方法，而不是内部指针的，指针指针的Release方法，会调用内部指针的Relase，然后设置内部指针为NULL,这样就可以防止多次释放接口。

 

     （7）CopyTo方法，拷贝后的智能指针生命周期完全独立。

 

            我们用CopyTo方法，将指针拷贝到一个out型参数。

 

      （8）Detach 和Attach方法

 

           在返回一个我们不再需要的接口指针给调用者的时候，我们可以用Deatch方法。

 

            当我们需要把原始指针的所有权转移到智能指针时候，用Attach方法。

 

 

       (9)  QueryInterface方法

              他只需要传入期望获得的接口类型的变量地址，即可。

 

              CComPtr<IFoo>   pFoo=...;

 

              CComPtr<IBar>   pBar;

 

              HRESULT   hr= pFoo.QueryInterface(&pBar);

 

       (10)  IsEqualObject方法

               IsEqualObject方法用来判断两个接口指针释放引用的是同一个对象。

 

              

 

       (11)  !=  和 ==  操作符

 

               跟普通的 一样

 

       (12)  CComPtr对IDispatch的特化

 

               CComPtr<IDispatch>  iptr;

 

               属性调用的辅助函数

               111.  GetIDOfName(LPCOLESTR  lpsz,DISPID  * pdispid)

                        这个方法，获得属性的DISPID

 

                222.GetProPerty(DISPID  dwDispid,  VARIANT *  pVar)

                       这个方法，获得属性。

                       SetProPerty(DISPID  dwDispid,  VARIANT *  pVar)

                       这个方法，设置属性。

 

               333. GetPropertyByName(LPCOLESTR lpsz, VARIANT * pVar)

                       SetPropertyByName(LPCOLESTR lpsz, VARIANT * pVar)

                       直接通过名称，获得和设置属性。

 

 

                            

               方法调用的辅助函数：

               111. HRESULT  Invoke0(DISPID dispid,VARIANT * pvarRet=NULL);

                       通过DISPID调用 没有参数的方法。

 

                       HRESULT  Invoke0(LPCOLESTR  lpszName, VARIANT * pvarRet=NULL);

                       通过方法名称，调用没有参数的方法。

 

                       HRESULT  Invoke1(DISPID dispid,VARIANT * param1, VARIANT *

pvarRet=NULL);

                       通过DISPID调用 有一个参数的方法。

 

                       HRESULT  Invoke1(LPCLOESTR  lpszName ,VARIANT * param1,

VARIANT * pvarRet=NULL);

                       通过方法名称，调用有一个参数的方法。

 

 

                       HRESULT  InvokeN(DISPID dispid,VARIANT* params, int  nParams,   VARIANT * pvarRet=NULL);

                       通过DISPID调用有N个参数的方法。

 

                       HRESULT InvokeN(LPCLOESTR   lpszName ,VARIANT * params,int  nParams,  VARIANT * pvarRet=NULL);

                      通过方法名称调用有N个参数的方法。

 

                       注意，通过参数列表的方法调用的时候，参数是反向的顺序，最后一个参数是元素0。  切记。