COM编程中的QueryInterface函数说解 C++ COM编程之QueryInterface函数（一）

这里的STDMETHODCALLTYPE表示调用方式，也就是windowshttps://m.qb5200.com/API的__stdcall方式。可以看到，在IUnknown中定义了一个名为QueryInterface的函数。客户可以调用QueryInterface来判断组件是否支持某个特定的接口，而对于剩下的AddRef和Release两个接口操作，我会在之后的文章中进行总结。

所有的COM接口都需要继承IUnknown接口；因此，如果某个客户拥有一个IUnknown接口的指针，它并不需要知道它所拥有的接口指针到底是指向什么类型的，而只需要知道此接口可以用来查询其它接口就行了。

由于所有的COM接口都首先继承了IUnknown，再根据对之前的文章COM编程——接口的背后https://m.qb5200.com/的理解，我们可以知道每个接口的vtbl中的前三个函数都是QueryInterface,AddRef和Release。这就使得所有的COM接口都可以被当成IUnknown接口来处理。如果某个接口的vtbl中的前三个函数不是这三个，那么它将不是一个COM接口。由于所有的接口都是从IUnknown继承而来的，因此所有的接口都支持QueryInterface。所以，组件的任何一个接口都可以被客户用来获取它所支持的其他接口。由于所有的接口指针同时也将是IUnknown指针，客户并不需要单独维护一个代表组件的指针，它所关心的将仅仅是接口的指针。

既然，我们可以只用QueryInterface去询问组件是否支持某个接口，但是，这一切都是基于获得了IUnknown接口指针之后，才能进行的操作，那么如何获得一个指向组件的IUnknown接口指针呢？我们可以实现一个CreateInstance函数，它建立一个组件并返回一个IUnknown指针；对于客户来说，可以调用CreateInstance获得IUnknown指针，而不用使用new操作符了。在系统的总结了COM的所有基础知识之后，我再说说系统提供的一个创建组件实例的API函数。

关于QueryInterface

IUnknown中包含一个名为QueryInterface的成员函数，客户可以通过此函数来查询某个组件是否支持某个特定的接口。若支持，QueryInterface将返回一个指向此接口的指针；否则返回值将是一个错误代码；然后客户可以接着查询其它接口。

从QueryInterface函数的声明中可以看出，QueryInterface有两个参数，第一个参数标识客户所需的接口，这个参数是一个接口标识符（IID）结构，在之后的文章中，我会总结有关IID的知识的；第二个参数用来存放所请求的接口的地址。QueryInterface返回的是一个HRESULT值，它是一个具有特定结构的32位值，之后我也会进行总结的；对于返回的HRESULT值，在实际开发中，需要使用SUCCEEDED宏或FAILED宏去进行判断HRESULT值是表示成功还是失败。

QueryInterface的简单实现

总结了QueryInterface的简单实现，说白了，就是简单工厂模式的实现；上面也说了，就是根据客户提供的IID接口标识符，然后获得对应的接口的指针，返回对应的接口的指针；如果组件支持客户指定的接口，那么应返回S_OK以及相应的指针；若不支持，返回值应是E_NOINTERFACE，并将相应的指针返回值置成NULL。下面通过一个简单的例子来说明QueryInterface的简单实现：

比如有上述的一个结构；接口IX和IY都继承自IUnknown接口，组件CA实现了IX和IY接口，那么QueryInterface的实现应该像下面这样：

复制代码https://m.qb5200.com/代码如下: HRESULThttps://m.qb5200.com/__stdcallhttps://m.qb5200.com/CA::QueryInterface(consthttps://m.qb5200.com/IIDhttps://m.qb5200.com/&iid,https://m.qb5200.com/voidhttps://m.qb5200.com/**ppv) {     https://m.qb5200.com/ifhttps://m.qb5200.com/(iidhttps://m.qb5200.com/==https://m.qb5200.com/IID_IUnknown)     https://m.qb5200.com/{          https://m.qb5200.com/*ppvhttps://m.qb5200.com/=https://m.qb5200.com/static_cast<IXhttps://m.qb5200.com/*>(this);     https://m.qb5200.com/}     https://m.qb5200.com/elsehttps://m.qb5200.com/ifhttps://m.qb5200.com/(iidhttps://m.qb5200.com/==https://m.qb5200.com/IID_IX)     https://m.qb5200.com/{          https://m.qb5200.com/*ppvhttps://m.qb5200.com/=https://m.qb5200.com/static_cast<IXhttps://m.qb5200.com/*>(this);     https://m.qb5200.com/}     https://m.qb5200.com/elsehttps://m.qb5200.com/ifhttps://m.qb5200.com/(iidhttps://m.qb5200.com/==https://m.qb5200.com/IID_IY)     https://m.qb5200.com/{          https://m.qb5200.com/*ppvhttps://m.qb5200.com/=https://m.qb5200.com/static_cast<IYhttps://m.qb5200.com/*>(this);     https://m.qb5200.com/}     https://m.qb5200.com/else     https://m.qb5200.com/{          https://m.qb5200.com/*ppvhttps://m.qb5200.com/=https://m.qb5200.com/NULL;          https://m.qb5200.com/returnhttps://m.qb5200.com/E_NOINTERFACE;     https://m.qb5200.com/}     https://m.qb5200.com/static_cast<IUnknownhttps://m.qb5200.com/*>(*ppv)->AddRef();     https://m.qb5200.com/returnhttps://m.qb5200.com/S_OK; }

QueryInterface的简单使用

当我获得了一个IUnknown指针以后，就可以调用对应的QueryInterface进行查询了，如下： 复制代码https://m.qb5200.com/代码如下: voidhttps://m.qb5200.com/Fod(IUnknownhttps://m.qb5200.com/*pI) {     https://m.qb5200.com/IXhttps://m.qb5200.com/*pIXhttps://m.qb5200.com/=https://m.qb5200.com/NULL;     https://m.qb5200.com///https://m.qb5200.com/Askhttps://m.qb5200.com/forhttps://m.qb5200.com/interfacehttps://m.qb5200.com/IX     https://m.qb5200.com/HRESULThttps://m.qb5200.com/hrhttps://m.qb5200.com/=https://m.qb5200.com/pI->QueryInterface(IID_IX,https://m.qb5200.com/(voidhttps://m.qb5200.com/**)&pIX);     https://m.qb5200.com///https://m.qb5200.com/Checkhttps://m.qb5200.com/thehttps://m.qb5200.com/returnhttps://m.qb5200.com/value     https://m.qb5200.com/ifhttps://m.qb5200.com/(SUCCEEDED(hr))     https://m.qb5200.com/{          https://m.qb5200.com///https://m.qb5200.com/Usehttps://m.qb5200.com/thehttps://m.qb5200.com/interface          https://m.qb5200.com/pIX->Fx();     https://m.qb5200.com/}   https://m.qb5200.com/ }

完整的例子

上面说了那么多了，现在提供一个完整的例子，将上面的各种理论知识都在实际代码中进行了实践，让各位能更好的理解QueryInterface。（下载）。

总结

QueryInterface理解起来比较简单，但是，它的理论知识还是必须要去掌握的，理论是一切的基础，没有理论作为支撑，任何实际的操作都不会那么可靠和可信，所以，这篇文章总结的偏于理论多一些。由于QueryInterface部分的内容比较多，使用一篇文章无法总结的齐全，所以，之后我还会继续总结关于QueryInterface的第二部分。