1. 全栈程序员必看首页

IUnKNown接口——QueryInterface函数

全栈程序员-用户IM • • 未分类

IUnKNown接口——QueryInterface函数COM笔记-QueryInterface函数fangyukuan2010.6.1客户同组件的交互都是通过一个接口完成的。在客户查询组件的其他接口时，也是通过接口完成的。这个接口就是IUnknown。它在UNKNWN.H头文件定义：如下       Interface IUnknown       {            virtual HRESULT _

大家好，又见面了，我是你们的朋友全栈君。

fangyukuan

2010.6.1

客户同组件的交互都是通过一个接口完成的。在客户查询组件的其他接口时，也是通过接口完成的。这个接口就是IUnknown。它在UNKNWN.H头文件定义 ：如下

       Interface IUnknown

       {

            virtual HRESULT __stdcall QueryInterface( REFIID riid, void ** ppvObject) = 0;

            virtual ULONG __stdcall  AddRef( void) = 0;

            virtual ULONG __stdcall  Release( void) = 0;

}

 

所有的COM接口都继承了IUnknown，每个接口的vtbl中的前三个函数都是QueryInterface、AddRef、Release（如图3-1）。这样所有COM接口都可以被当成IUnknown接口来处理。

IUnKNown接口——QueryInterface函数

由于所有的接口都是从IUnknown继承的，因此所有的接口都支持QueryInterface，所以组件的任何一个接口都可以被客户用来获取它所支持的其他接口。

 

QueryInterface

IUnknown的一个成员函数QueryInterface，客户可以通过此函数来查询某个组件是否支持某个特定的接口。若支持QueryInterface将返回一个指向些接口的指针，不支持返回值将是一个错误代码。

 

QueryInterface 有两个参数，和一个HRESULT返回值

HRESULT __stdcall QueryInterface( REFIID riid, void ** ppvObject);

 

第一个参数：接口标识符（IID）

第二个参数：存放所请求接口指针的地址。

返回值：查询成功返回S_OK，如果不成功则返回相应错误码。

 

QueryInterface的使用

void foo(IUnknown* pI)

{

    // 定义一个接口指针

    IX* pIX = NULL;

 

    // 查询接口IX

    HRESULT hr = pI->QueryInterface(IID_IX, (void**)&pIX);

    if (SUCCEEDED(hr))

    {

       // 通过接口调用函数

       pIX->Fx();

    }

}

 

QueryInterface实现

 

根据某个给定的IID返回指向相应接口的指针。若组件支持客户指定的接口，那么应返回S_OK以及相应的指针。若不支持返回测返回E_NoINTERFACE并将相应的指针返回值置成NULL。

QueryInterface的实现要求可以将一种类型映射成另外一种类型的结构。如：if else 、数组、哈希表或者是树来实现，但是case语句是无法用的。因为接口标识符是一个结构而不是一个数。

 

IUnKNown接口——QueryInterface函数

注意：IX和IY不能按虚拟方式继承IUnknown。否则IX和IY的vtbl中的头三个函数指向的将不是IUnknown的三个成员函数。

HRESULT __stdcall CA::QueryInterface(const IID& iid, void** ppv)

{  

    if (iid == IID_IUnknown)

    {

       trace(“QueryInterface: Return pointer to IUnknown.”);

       *ppv = static_cast<IX*>(this);

    }

    else if (iid == IID_IX)

    {

       trace(“QueryInterface: Return pointer to IX.”);

       *ppv = static_cast<IX*>(this);

    }

    else if (iid == IID_IY)

    {

       trace(“QueryInterface: Return pointer to IY.”);

       *ppv = static_cast<IY*>(this);

    }

    else

    {     

       trace(“QueryInterface: Interface not supported.”);

       *ppv = NULL;

       return E_NOINTERFACE;

    }

    reinterpret_cast<IUnknown*>(*ppv)->AddRef();

    return S_OK;

}

 

 

IUnknown

接口标准化，在COM中有两方面的内容：一是接口基本功能的标准化，二是接口内存结构的标准化。为了保证组件接口在基本功能上的标准化，COM预定义了一个基本接口IUnknow。（在文件UNKNWN.H中定义）

Class   Iunknown

{

    Public:

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

        Virtual  HRESULT _stdcal   AddRef( )=0;

        Virtual  HRESULT _stdcal   Release( )=0;

};

显然，Iunknown接口具有3个纯虚函数。COM 要求组件的所有接口必须继承自IUnknown接口，这样就保证组件的所有接口都能提供这3个服务（函数）。

 

一个完整的例子

（vs2008)代码下载：http://www.box.net/shared/m4yr9z73zu

复制代码
 #include <iostream> using namespace std; #include <objbase.h> void trace( const char* msg) { cout << msg << endl; } //  接口定义   interface IX : IUnknown { virtual void __stdcall Fx() = 0; }; interface IY : IUnknown { virtual void __stdcall Fy() = 0; }; interface IZ : IUnknown { virtual void __stdcall Fz() = 0; }; //  Forward references for GUIDs   extern const IID IID_IX; extern const IID IID_IY; extern const IID IID_IZ; //   //  实现接口 IX,IY(这里表示一个组件）  //  class CA : public IX, public IY { // IUnknown implementation   virtual HRESULT __stdcall QueryInterface( const IID& iid, void** ppv); virtual ULONG __stdcall AddRef() { return 0;} virtual ULONG __stdcall Release() { return 0;} //  Interface IX implementation   virtual void __stdcall Fx() { cout << " 这里是Fx函数 " << endl;} //  Interface IY implementation   virtual void __stdcall Fy() { cout << " 这里是Fy函数 " << endl;} }; HRESULT __stdcall CA::QueryInterface( const IID& iid, void** ppv) { if (iid == IID_IUnknown) { trace( " QueryInterface: Return pointer to IUnknown. "); *ppv = static_cast<IX*>( this); } else if (iid == IID_IX) { trace( " QueryInterface: Return pointer to IX. "); *ppv = static_cast<IX*>( this); } else if (iid == IID_IY) { trace( " QueryInterface: Return pointer to IY. "); *ppv = static_cast<IY*>( this); } else { trace( " QueryInterface: Interface not supported. "); *ppv = NULL; return E_NOINTERFACE; } reinterpret_cast<IUnknown*>(*ppv)->AddRef(); //  加计数   return S_OK; } //   //  创建类CA,并返回一个指向IUnknown的指针  // IUnknown* CreateInstance() { IUnknown* pI = static_cast<IX*>( new CA); pI->AddRef(); return pI ; } //   //  下面是各接口的IID  //   //  {32bb8320-b41b-11cf-a6bb-0080c7b2d682}   static const IID IID_IX = { 0x32bb8320, 0xb41b, 0x11cf, { 0xa6, 0xbb, 0x0, 0x80, 0xc7, 0xb2, 0xd6, 0x82}}; //  {32bb8321-b41b-11cf-a6bb-0080c7b2d682}   static const IID IID_IY = { 0x32bb8321, 0xb41b, 0x11cf, { 0xa6, 0xbb, 0x0, 0x80, 0xc7, 0xb2, 0xd6, 0x82}}; //  {32bb8322-b41b-11cf-a6bb-0080c7b2d682}   static const IID IID_IZ = { 0x32bb8322, 0xb41b, 0x11cf, { 0xa6, 0xbb, 0x0, 0x80, 0xc7, 0xb2, 0xd6, 0x82}}; //   //  主函数（这里代表客户)  //  int main() { HRESULT hr; trace( " Client:获取 IUnknown指针. "); IUnknown* pIUnknown = CreateInstance(); trace( " Client:获取接口IX. "); IX* pIX = NULL; hr = pIUnknown->QueryInterface(IID_IX, ( void**)&pIX); if (SUCCEEDED(hr)) { trace( " Client:获取接口IX成功. "); pIX->Fx(); //  使用 IX.   } trace( " Client:获取接口IY. "); IY* pIY = NULL; hr = pIUnknown->QueryInterface(IID_IY, ( void**)&pIY); if (SUCCEEDED(hr)) { trace( " Client: Succeeded getting IY. "); pIY->Fy(); //  使用 IY.   } trace( " Client:是否支持接口IZ. "); IZ* pIZ = NULL; hr = pIUnknown->QueryInterface(IID_IZ, ( void**)&pIZ); if (SUCCEEDED(hr)) { trace( " Client:获取接口IZ成功. "); pIZ->Fz(); } else { trace( " Client:获取接口IZ失败，不支持接口IZ. "); } trace( " Client:用接口IX查询接口IY. "); IY* pIYfromIX = NULL; hr = pIX->QueryInterface(IID_IY, ( void**)&pIYfromIX); if (SUCCEEDED(hr)) { trace( " Client:获取接口IY成功. "); pIYfromIX->Fy(); } trace( " Client:用接口IY查询接口IUnknown. "); IUnknown* pIUnknownFromIY = NULL; hr = pIY->QueryInterface(IID_IUnknown, ( void**)&pIUnknownFromIY); if (SUCCEEDED(hr)) { cout << " IUnknown指针是否相等? "; if (pIUnknownFromIY == pIUnknown) { cout << " Yes, pIUnknownFromIY == pIUnknown. " << endl; } else { cout << " No, pIUnknownFromIY != pIUnknown. " << endl; } } //  Delete the component.   delete pIUnknown; return 0; }
复制代码

 

QueryInterface的实现规则

IUnKNown接口——QueryInterface函数 QueryInterface返回的总是同一IUnknown指针。

IUnKNown接口——QueryInterface函数 若客户曾经获取过某个接口，那么将总能获取此接口。如果曾经不能，则将总是不能。

IUnKNown接口——QueryInterface函数 客户可以再次获取已经拥有的接口。

IUnKNown接口——QueryInterface函数 客户可以返回到接口。

IUnKNown接口——QueryInterface函数 若能够从某个接口获取某特定接口，那么可以从任意接口都将可以获取此接口。

 

同一IUnknown指针:

组件的实例只有一个IUnknown接口。因为查询组件实例的IUnknown接口时，不论通过哪个接口，所得到的均将是同一指针值。所以可以通过两个接口的IUnknown，然后比较他们的值。看看是否相同来判断两个接口是否在同一个组件里。

/*

    判断两个接口是否在同一个组件里

*/

BOOL SameComponents(IX* pIX, IY* pIY)

{

    IUnknown* pI1 = NULL;

    IUnknown* pI2 = NULL;

 

    pIX->QueryInterface(IID_IUnknown, (void**)&pI1);

    pIY->QueryInterface(IID_IUnknown, (void**)&pI2);

    return pI1 == pI2;

}

 

QueryInterface定义了组件

一个组件实际上就是由QueryInterface定义的。组件所支持的接口集就是QueryInterface能够为之返回接口指针的那些接口。这一点是由QueryInterface的实现决定的，而不是由实现组伯的C++类决定的。实现组件的类的继承层次关系也不能决定组件。

 

新版本组件的处理

COM接口是不会发性变化的，当组件发布一个接口并补某个使用后，此接口将决不会发生任何变化。如果我们想改动它。只能通过增加新的接口。

 

何时需要建立一个新版本

当改了下列条件中任何一个时，就应该给新接口指定新的ID.

IUnKNown接口——QueryInterface函数 接口中函数的数目。

IUnKNown接口——QueryInterface函数 接口中函数的顺序。

IUnKNown接口——QueryInterface函数 某个函数的参数。

IUnKNown接口——QueryInterface函数 某个函数参数的顺序。

IUnKNown接口——QueryInterface函数 某个函数参数的类型。

IUnKNown接口——QueryInterface函数 函数可能的返回值。

IUnKNown接口——QueryInterface函数 函数返回值的类型。

IUnKNown接口——QueryInterface函数 函数参数的含义。

IUnKNown接口——QueryInterface函数 接口中函数的含义。

总之，只要是所做的修改会影响客户的正常运行，都应该为接口指定新的ID

本文地址：http://www.cnblogs.com/fangyukuan/archive/2010/06/02/1750377.html 

版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 举报，一经查实，本站将立刻删除。

发布者：全栈程序员-用户IM，转载请注明出处：https://javaforall.cn/148159.html原文链接：https://javaforall.cn

【正版授权，激活自己账号】： Jetbrains全家桶Ide使用，1年售后保障，每天仅需1毛

【官方授权 正版激活】： 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...

赞 (0)
全栈程序员-用户IM全栈程序员-用户IM
0 0
blank

相关推荐

  • MySQL自增主键数值莫名增加

    MySQL自增主键数值莫名增加

    MySQL自增主键数值莫名增加问题描述自增主键数值比计划中大，可能原因有很多。解决方案如果某次存储过程失败，也是会占用自增主键数值的。删除数据，已占用过的自增主键数值不会恢复，新插入数据会继续从删除之前的数值开始增加。所以，存储失败后，需要重新设置自增主键起始值。…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年6月17日
  • 小记录

    小记录

    小记录

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年4月3日
  • Idea2020创建javaweb项目-图文 idea

    Idea2020创建javaweb项目-图文

    Idea2020创建javaweb项目-图文选择在新窗口打开看到以下结果接下来将当前项目修改为web项目点击下方应用,创建web目录及web.xml文件开始编写代码,第一步导入jar包然后将需要的jar包复制到lib目录下,复制完成后,右键lib目录选择AddasLibrary….接下来就是创建包创建类以及页面,src选择右键创建packages及选择包右键选择javaclass创建类然后tomcat运行如果…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年9月2日
  • pycharm如何连接远程服务器_pycharm如何使用远程解释器

    pycharm如何连接远程服务器_pycharm如何使用远程解释器

    pycharm如何连接远程服务器_pycharm如何使用远程解释器pycharm提供了很方便的与服务器同步代码，并执行的插件。我在配置的时候遇到了个问题，后来折腾了两天，最后终于解决了，在此记录下配置的过程和怎么解决的。目的：pycharm连接远程的服务器，然后在本地写代码，自动提交服务器并且在服务器执行，结果显示在本地console。坑：设置ssh的配置没问题，本地与远程项目也同步了，远程的python解释器也指定了，但是跑代码遇到无法连接到远程con…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年8月26日
  • copy.deepcopy()_python切片是深拷贝还是浅拷贝

    copy.deepcopy()_python切片是深拷贝还是浅拷贝

    copy.deepcopy()_python切片是深拷贝还是浅拷贝copy()与deepcopy()之间的主要区别是python对数据的存储方式。首先直接上结论：—–我们寻常意义的复制就是深复制，即将被复制对象完全再复制一遍作为独立的新个体单独存在。所以改变原有被复制对象不会对已经复制出来的新对象产生影响。—–而浅复制并不会产生一个独立的对象单独存在，他只是将原有的数据块打上一个新标签，所以当其中一个标签被改变的时候，数据块就会发生变化

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年10月3日
  • Windows查看CUDA版本「建议收藏」

    Windows查看CUDA版本「建议收藏」

    Windows查看CUDA版本「建议收藏」方法1：进入以下目录C:\ProgramFiles\NVIDIAGPUComputingToolkit\CUDA即可安装的CUDA版本方法2：打开cmd，输入nvcc–version

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年4月28日

发表回复

您的电子邮箱地址不会被公开。

关注全栈程序员社区公众号