【COM学习】之一、QueryInterface

开始先说一句，学习com之前要学好c++ 对象模型。

QueryInterface的使用：

QueryInterface是IUnknown的一个成员函数，客户可以通过此函数来查询某个组件是否支持某个特定的接口。

QueryInterface成功返回一个指向此接口的指针。     错误返回一个错误代码。

HRESULT _stdcall QueryInterface(const IID& iid, void **ppv);

下面是一个QueryInterface的使用实例：（可知道相应的组件是否支持某个特定的接口）

void ceshi(IUnknown * pI)
{
       IX* pIX = NULL;
       HRESULT hr = pI->QueryInterface(IID_IX, (void**)&pIX);
       if(SUCCEEDED(hr))
       {
              pIX->Fx();
       }
}

我们查询pI 是否支持由IID_IX所标识的接口。

代码中主意的是   pIX需要初始化为NULL， 这是一种比较好的编程方法，在后面的实现中我们会看到  QueryInterface在失败时将把返回的接口指针置为NULL。

由于QueryInterface是由程序员而不是由系统实现的，因此某些组件可能并不会在查询失败时将此指针置为NULL。    为了安全，在程序中还是我们自己将其置为NULL比较好。

QueryInterface的实现：

他的实现需要完成的不过是根据某个给定的IID返回指向相应接口的指针。

若组件支持客户指定的接口，那么应返回S_OK 以及相应的指针。

若不支持，返回值应为： E_NOINTERFACE 并将相应的指针返回值置为NULL。

HRESULT _stdcall CA::QueryInterface(const IID& iid, void ** ppv)
{
    if(iid == IID_IUnknown)
    {
         *ppv = static_cast<IX*>(this);
    }else if(iid == IID_IX)
    {
         *ppv = static_cast<IX*>(this);
    }else if(iid == IID_IY)
    {
         *ppv = static_cast<IY*>(this)
    }else
    {
         *ppv = NULL;
         return E_NOINTERFACE;
    }
    static_cast<IUnknown*>(*ppv)->AddRed();
    return S_OK;
}

QueryInterface 的末尾调用AddRef实际上没有任何作用，后面讨论 AddRef；

QueryInterface的实现规则：

1.QueryInterface返回的总是同一IUnknown指针。

2.若客户曾经获取过某个接口，那么它将总能获取此接口。

3.客户可以再次获取已经拥有的接口。

4.客户可以返回到起始接口。

5.若能从某个接口获取某特定接口，那么可以从任意接口都将可以获取此接口。

QueryInterface定义了组件：

QueryInterface是COM最为重要的部分，因为一个组件实际上就是由QueryInterface定义了，组件所支持的接口集就是QueryInterface能够为之返回接口指针的那些接口。

这是由QueryInterface的实现决定的，而不是由实现组件的C++类决定的。

客户不知道QueryInterface的实现，他将无法知道一个组件所支持的所有接口。   客户了解组件所支持接口的唯一方法是进行查询。

COM类似于在某次社交聚会上同某人会面，而与对他们进行工作面试有很大不同，当进行工作面试时，被试者将提交一份介绍他情况的个人简历。这份简历类似于c++类的定义。而社交聚会上会面时，没有人会给对方提供个人简历。为了了解情况，必须询问。   这一点类似于COM组件。

新版本的处理：

Com中，接口是不会发生改变的，当组件发布一个接口并被某个客户使用之后，此接口将绝不会发生任何变化，而将永远保持不变。

每一个接口都有一个唯一的接口标识符IID，  一般情况下，我们不会改变接口，而可以建立一个新接口并为之指定一个新的IID。

当QueryInterface 接收到对老IID  的查询时，他将返回老接口，   而当他收到对新的IID的查询时，他将返回新的接口。

对QueryInterface 而言， 一个IID 就是一个接口。

新的接口可以继承老接口，他也可以同老接口完全不同。  由于老接口仍然保持不变，已有客户的运行将不会收到任何影响。

新客户可以自行决定是使用老接口还是新接口，因为他可以自由决定到底查询那个接口。

接口的IID  据定了它的版本，当客户获取某个接口时，由于不同版本的接口实际上是不同的接口，他们各自具有不同的ID，因此客户仍能取得正确的版本的接口。

我们何时需要建立一个新版本？

当改变下列条件中的任何一个时，就应该给新街口指定新的id。

1、接口中函数的数目；

2、接口中函数的顺序；

3、某个函数的参数；

4.、某个函数参数的顺序；

5、某个函数参数的类型；

6、函数可能的返回值；

7、函数返回值的类型；

8、函数参数的含义；

9、接口中函数的含义。

只要是所做的修改会导致已有客户的正常运行，就需要接口指定新的ID。

2013.8.4

jofranks 于南昌