《COM技术内幕》读书笔记——第3章 QueryInterface函数

所有COM的接口都需要继承一个接口——IUnknown，接口的定义在UNKNWN.H文件中，我所使用的7.0库版本中所带的定义为：

        IUnknown
        {
        public:
            BEGIN_INTERFACE
            virtual HRESULT STDMETHODCALLTYPE QueryInterface( 
                /* [in] */ REFIID riid,
                /* [iid_is][out] */ __RPC__deref_out void __RPC_FAR *__RPC_FAR *ppvObject) = 0;

            virtual ULONG STDMETHODCALLTYPE AddRef( void) = 0;

            virtual ULONG STDMETHODCALLTYPE Release( void) = 0;

            template<class Q>
            HRESULT
#ifdef _M_CEE_PURE
            __clrcall
#else
            STDMETHODCALLTYPE
#endif
            QueryInterface(Q** pp)
            {
                return QueryInterface(__uuidof(Q), (void **)pp);
            }

            END_INTERFACE
        };

书中指出，QueryInterface,AddRed,Release这三个函数是规范的接口函数，是否是COM接口的标志就是看接口的虚表前三个函数是不是这三个函数。这里代码中多出一个只带Q** pp参数的QueryInterface只是为了方便使用而做的实现，可以在理解过程中把此忽略。

IUnknown中包含一个名为QueryInterface的成员函数，客户可以通过此函数来查询某个组件是否支持某个特定的接口。注意查询是否存在时返回值的判断需要使用对应的宏来做，以免出现不必要的误解。

QueryInterface的使用示例：

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

	if (SUCCEEDED(hr))
	{
		Client1_trace("Succeeded getting IX.") ;
		pIX->Fx() ;          // Use interface IX.
		pIX->Release() ;
	}
	else
	{
		Client1_trace("Could not get interface IX.") ;
	}

QueryInterface对所有的IUnknown接口查询请求都必须返回相同的指针。

QueryInterface的实现规则：

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

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

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

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

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