com学习笔记(2)基本的com接口-QueryInterface的实现

QueryInterface 接上篇

一.COM接口的开始IUnknown

com起于接口，又归于接口.

com之所以是com,是因为其继承了一个名为IUnknown接口 .

IUnknown接口是一个非常有趣的名字.我们第一次看到这个接口,都会非常好奇,名字的由来开发内部肯定是有故事的,或者他们想不出啥好名字也是有可能的.

下面我们来看一下IUnknown接口定义了哪些成员,这篇只讲QueryInterface

interface 
IUnknown

{

    virtual 
HRESULT __stdcall 
QueryInterface(const 
IID& iid, void
** ppv) =0;            

    virtual 
ULONG __stdcall 
AddRef() =0 ;

    virtual 
ULONG __stdcall 
Release() =0 ;


};

二.QueryInterface的实现与使用

1.作用

看命名就可以猜这个方法是用来查询组件是否支持某个特定接口。若支持泽返回指向此接口的指针。

2.参数

QueryInterface方法有两个参数,

第一个为接口标识符,简称IID,全名(Interface Identifier),现在可以只理解为一个常量

第二个参数即为返回的接口指针

3.使用方法

我们先来看示例代码

定义一个继承自IUnknown接口的IX

interface 
IX : IUnknown

{

    virtual void __stdcall 
Fx() = 0 ;

} ;

若CA实现了该IX接口,则使用如下

static const 
IID IID_IX = 

    {0x32bb8320, 0xb41b, 0x11cf,

    {0xa6, 0xbb, 0x0, 0x80, 0xc7, 0xb2, 0xd6, 0x82}} ;



void 
foo(IUnknown* pI)

{

    IX* pIX=NULL;

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



    if
(SUCCEEDED(hr)

    {

       pIX->Fx();

    }

}

3.1 HRESULT

HRESULT是一个查询结果状态集合，并非true或false可以表示的，所以用SUCCEEDED方法来判断查询结果是否成功，失败的话，接口指针为NULL.

4.QueryInterface的实现

CA继承了IX，由于IX继承了IUnknown接口，所以CA也必须实现IUnknown接口成员,我们重新来看一下QueryInterface方法的参数

virtual HRESULT __stdcall QueryInterface(const IID& iid, void ** ppv) =0;

该方法会根据传输不同iid,而返回相对应的接口指针,为了演示，我们再定义一个接口IY,CA实现IX和IY，

如下实现

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;

    }

    return 
S_OK ;

}

是不是很简单？,获取到以后用static_cast 来转换类型。IID_IUnknown,S_OK，E_NOINTERFACE等都是内置的状态码

5.简单创建IUnknown

IUnknown* CreateInstance()

{

    IUnknown* pI = static_cast
<IX*>(new 
CA) ;

    pI->AddRef() ;

    return 
pI ;

}

6.调用接口

int 
main()

{

    HRESULT hr ;    

    IUnknown* pIUnknown = CreateInstance() ;

   

    IX* pIX = NULL ; 

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

    if 
(SUCCEEDED(hr))

    {

        pIX->Fx() ;          // Use interface IX.

    
}



    IY* pIY = NULL ;

    hr = pIUnknown->QueryInterface(IID_IY, (void
**)&pIY) ;

    if 
(SUCCEEDED(hr))

    {

        pIY->Fy() ;          // Use interface IY.

    
}



    // Delete the component.

    
delete 
pIUnknown ;

    return 
0 ;

}