IUnKNown接口——QueryInterface函数

最新推荐文章于 2024-07-14 14:47:44 发布
最新推荐文章于 2024-07-14 14:47:44 发布
阅读量1.3k 收藏 2
点赞数
分类专栏： win 文章标签： windows

转自:IUnKNown接口——QueryInterface函数

客户同组件的交互都是通过一个接口完成的。在客户查询组件的其他接口时，也是通过接口完成的。这个接口就是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，所以组件的任何一个接口都可以被客户用来获取它所支持的其他接口。

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语句是无法用的。因为接口标识符是一个结构而不是一个数。


注意：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个服务（函数）。

一个完整的例子

#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的实现规则

1.QueryInterface返回的总是同一IUnknown指针。
2.若客户曾经获取过某个接口，那么将总能获取此接口。如果曾经不能，则将总是不能。
3.客户可以再次获取已经拥有的接口。
4.客户可以返回到接口。
5.若能够从某个接口获取某特定接口，那么可以从任意接口都将可以获取此接口。

同一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++类决定的。实现组件的类的继承层次关系也不能决定组件。



Eugene800
关注
专栏目录
C++ COM编程之QueryInterface函数（二）
01-20
前言 在COM编程——认识组件中也总结了，COM是一个说明如何建立可动态互变组件的规范，它提供了为保证能够互操作，客户和组件...因为当查询组件实例的IUnknown接口时，不论通过哪个接口，所得到的均将是同一指针值。为
C++ COM编程之QueryInterface函数（一）
liujiayu2的专栏
04-16 1704
前言 组件对外公布的是接口；一个组件可以实现多个接口，也就是说可以对外公布多个接口，之前也总结过了，你很少会100%的去完全了解一个组件的所有接口，就像你去学习编程一样，你几乎不可能去成为编程中的全才。那么，既然我们不能去完全的了解一个组件提供的所有接口，那么我们在实际开发中，如何去判断一个组件是否提供对应的接口呢？看文档？是的，是个好主意，在文档的海洋，找到一个知识点，真的很难，浪费时间和
com 的 IUnknown 接口的了解
baidu_16370559的博客
05-31 877
1.一切类的继承都是源于IUnknown 和CUnknown 。 typedef CComPtr< IUnknown > IUnknownPtr; typedef CComPtr< CUnknown > CUnknownPtr; IUnknown 是com 的接口 C++实现COM技术规范是通过一个名为IUnKnown的抽象类，即包含纯虚函数的类，这样的类即称为接口。 该类只有三个函数：QueryInterface、AddRef、Release，且都是纯虚函数，一个可执行文件的类只要
COM编程攻略（三 硬核ATL实现IUnknown代码解析）
heusunduo88的博客
03-15 528
COM编程攻略（三 硬核ATL实现IUnknown代码解析）
COM技术内幕--QueryInterface函数
crkres9527
12-15 3609
接口查询： 在客户查询组件的其他接口时，也是通过接口完成的。这个接口就是IUnknown. 头文件包含在Win32 SDK的unknwn.h头文件中。 引用如下： interface IUnknown { virtual HRESULT __stdcall QueryInterface(const IID& iid,void** ppv)=0; virtual
Windows API 开发详解——函数、接口、编程实例
11-02
例如，`IUnknown`接口是所有COM对象的基础，提供了`QueryInterface`、`AddRef`和`Release`三个方法，分别用于获取对象接口、增加引用计数和释放资源。通过COM接口，开发者可以使用各种系统服务，如动态链接库（DLLs...
精通Windows.API-函数、接口、编程实例
06-08
《精通Windows.API——函数、接口、编程实例》是一本深入探讨Windows操作系统编程的书籍，它主要聚焦于如何利用API函数和接口进行系统级的开发。Windows API是Windows操作系统提供的一系列函数和接口，它们允许...
windows api开发详解--函数、接口、编程实例
10-17
比如，IUnknown接口是所有COM（组件对象模型）接口的基础，它提供了`QueryInterface()`、`AddRef()`和`Release()`三个方法，用于对象的查询、引用计数和释放。另外，GDI（图形设备接口）和USER（用户界面）接口提供...
COM 组件设计与应用（八）——实现多接口VC源代码
03-15
5. **使用组件**：在客户端代码中，可以通过`CoCreateInstance`函数实例化组件，并使用`QueryInterface`获取所需的接口指针，然后调用接口方法。 ```cpp CComPtr<IMyInterface1> pInterface1; HRESULT hr = ...
第三章：QueryInterface函数
最新发布
qq_74544400的博客
07-14 770
有一个名叫Animal的游戏程序，它内部维护了一个二叉树，可以通过询问玩家问题来沿着一个分支来向答案推荐，以此猜测玩家心中所想的动物（Animal），同此程序并不知道用户所假想的动物是什么一样，即使最后猜到玩家心中的答案，但“Animal”程序对于此动物的了解也是停留在几个表象特征，他并不能像玩家一样对他所猜到的答案有一个完整的认知，COM客户同理，客户可以询问组件是否支持某个特定的接口。在进行多次这种询问之后,客户对于组件的认识将越来越清晰。但不管怎样,。不过这并不是一个负面影响，因为。
IUnknown接口QueryInterface函数介绍
firststudy的专栏
02-21 8935
一、COM组件的目标：COM组件的一个主要优势是：便于升级。要实现这个优势需要满足一下两个条件：1、运行时从客户程序动态加载和卸载，采用DLL技术可以实现。2、为了更好的突出DLL的优势，还需要信息隐藏，即封装性。 二、COM组件的信息隐藏采用IUnknown接口来实现：       1、IUnknown接口功能简介：IUnknown意思是未知，即未知的接口。采用这
Iunknown的QueryInterface查询接口的作用
JING_HUANG
07-29 1929
<br />COM组件的一个主要优势是：便于升级。要实现这个优势需要满足两个条件：<br />1>为了更好的突出DLL的优势，还需要信息隐藏，即封装性。<br />2>运行时客户程序可动态加载和卸载，采用DLL技术可以实现。<br /> <br />1>从封装性看：<br />      COM组件的信息隐藏采用IUnknown接口来实现，IUnknown意思是未知，即未知的接口，所有的COM接口都需要继承IUnknown接口,因此若某个客户拥有一个IUnknown接口的指针，一是他不知道接口到底是什么类型
windows - COM 组件介绍
tuan8888888的博客
10-15 6173
文章目录COM 简介概念CoCreateInstanceIUnKnown 接口IUnknown 的工作原理引用计数接口查询 COM 简介 Microsoft 组件对象模型 (COM) 是一个独立于平台的分布式面向对象的系统，用于创建可交互的二进制软件组件。 COM 是 Microsoft 的 OLE (复合文档) 、ActiveX (Internet 组件) 等的基础技术。 若要了解 COM (所有基于 COM 的技术) ，必须了解它不是面向对象的语言，而是一种标准。 用于创建在运行时进行交互的可重用的软件
c++简单快速理解QueryInterface（带图）
daisy.skye的博客
09-28 1386
QueryInterface的简单实现，根据客户提供的IID接口标识符，然后获得对应的接口的指针，返回对应的接口的指针。 每个接口的vtbl中的前三个函数都是QueryInterface,AddRef和Release。 virtual(虚函数) vtbl(虚函数表)与vptr(虚函数表指针)，类的虚函数表是一块连续的内存，每个内存单元中记录一个JMP指令的地址（JMP指汇编语言即底层语言）。 ...
零基础学习COM之IUnknown抽象接口介绍
系统运维
11-24 417
零基础学习COM之IUnknown抽象接口介绍 传统的软件由单个的二进制文件组成。组件将单个二进制文件分割为多个独立的部分，每个部分都被称为一个组件。采用组件技术后，在需要对程序进行修改和改进时，只需替换某个组件模块即可。 在开发程序时可以从组件库中选择合适的组件快速构造出满足需要的应用程序。这大大提高了程序的可维护性和开发效率。 组件化程序设计思想是将复杂的应用程序被设...
const IID IID_IUnknown
autumn20080101的专栏
03-30 1964
EXTERN_C const IID IID_IUnknown; #if defined(__cplusplus) && !defined(CINTERFACE) #if (_MSC_VER >= 1200) // VC6 or greater extern "C++" { #endif MIDL_INTERFACE("00000000-0000-0000-C000-00000000
COM编程之三 QueryInterface
weixin_33749242的博客
11-21 256
【1】IUnknown接口 客户同组件交互都是通过接口完成的。 在客户查询组件的其它接口时，也是通过接口完成的。而那个接口就是IUnknown。 IUnknown接口的定义包含在Win32SDK中的UNKNEN.h头文件中。引用如下： 1 interface IUnknown 2 { 3 virtual HRESULT __stdcall QueryInterface(co...
【COM学习】之一、QueryInterface
编程之道，自强之路！
08-04 8135
开始先说一句，学习com之前要学好c++ 对象模型。 QueryInterface的使用： QueryInterface是IUnknown的一个成员函数，客户可以通过此函数来查询某个组件是否支持某个特定的接口。 QueryInterface成功返回一个指向此接口的指针。     错误返回一个错误代码。 HRESULT _stdcall QueryInterface(const
COM组件开发：嵌套类实现IUnknown接口详解
在给定的代码片段中，我们看到一个嵌套类`XDictionary`在`CDictionary`类内部实现`IUnknown`的`QueryInterface`成员函数。这段代码展示了如何在一个特定的COM对象中实现`IUnknown`接口的规范。`STDMETHODIMP_(ULONG)...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值