ATL学习笔记: COM接口映射表
CComObjectRootBase中以表驱动的方式对接口的查询作了一个内部的实现,即InternalQueryInterface()。所以在创建基于ATL的COM类时,需要创建一个包含所有实现接口的映射表。
1. BEGIN_COM_MAP、END_COM_MAP、COM_INTERFACE_ENTRY与COM_INTERFACE_ENTRY2宏
ATL提供了BEGIN_COM_MAP、END_COM_MAP、COM_INTERFACE_ENTRY与COM_INTERFACE_ENTRY2这4个宏来创建接口映射表。
假设一个类CClassA继承了接口IIntA和IIntB,则该类的接口映射表创建如下:
class CClassA : public CComObjectRootEx<CComSingleThreadMode>
{
BEGIN_COM_MAP(CClassA)
COM_INTERFACE_ENTRY(IIntA)
COM_INTERFACE_ENTRY(IIntB)
END_COM_MAP()
......
};
而当CClassB继承了IIntC和IIntD,并且IIntC和IIntD都继承自IDispatch接口。此时,如果客户程序在查询IDispatch接口,QueryInterface所返回的IDispatch接口指针将无法确定其属于IIntC还是IIntD。在这种情况下,需要指定IDispatch接口指针的默认指向。 COM_INTERFACE_ENTRY2()宏即是用于完成该功能。下面代码将对IDispatch接口的请求默认指向属于IIntD的IDispatch接口指针。
class CClassB : public CComObjectRootEx<CComSingleThreadMode>
{
BEGIN_COM_MAP(CClassA)
COM_INTERFACE_ENTRY(IIntC)
COM_INTERFACE_ENTRY(IIntD)
COM_INTERFACE_ENTRY2(IDispatch, IIntD)
END_COM_MAP()
......
};