ATL接口映射宏详解(下).docVIP

ATL接口映射宏详解(下) 五．COM_INTERFACE_ENTRY_AGGREGATE(iid, punk) 参ATL例程COMMAP 这一节中将介绍ATL中用于聚集对象的宏。聚集对象的概念请参阅其它参考书。 现在先看一看这个宏的典型用法： class CAgg : public IDispatchImpl IAgg, IID_IAgg, LIBID_AGGREGLib , public ISupportErrorInfo, public CComObjectRoot, public CComCoClass CAgg,CLSID_CAgg { ..... }; CAgg是一个聚集类，它的实现与一般的ATL组件没有区别，只是注意在它的类定义中不要加入DECLARE_NO_AGGREGATABLE. class COuter : public CChainBase, public IDispatchImpl IOuter, IID_IOuter, LIBID_COMMAPLib , public CComCoClass COuter,CLSID_COuter { HRESULT FinalConstruct(); void FinalRelease(); BEGIN_COM_MAP(COuter) COM_INTERFACE_ENTRY_AGGREGATE(IID_IAgg, m_pUnkAgg.p) END_COM_MAP() DECLARE_GET_CONTROLLING_UNKNOWN() CComPtr IUnknown m_pUnkAgg; }; COuter包含了聚合组件CAgg,它包含了几个不同之处： (1)加入了COM_INTERFACE_ENTRY_AGGREGATE(IID_IAgg, m_pUnkAgg.p)宏。 #define COM_INTERFACE_ENTRY_AGGREGATE(iid, punk)\ {iid,\ (DWORD)offsetof(_ComMapClass, punk),\ _Delegate}, offsetof我们在上一节中已经见过，可以猜到它求的就是punk在类中的位置。也就是m_pUnkAgg在COuter中的位置。 (2)加入了宏DECLARE_GET_CONTROLLING_UNKNOWN()，其定义为： #define DECLARE_GET_CONTROLLING_UNKNOWN() public:\ virtual IUnknown* GetControllingUnknown() {return GetUnknown();} 我们也没必要继续深究下去，仅从字面意思就可以看出这个函数将返回组件的IUnknown 指针。 (3)在COuter中加入一个成员变量：CComPtr IUnknown m_pUnkAgg; m_pUnkAgg将用于获得被聚集组件的IUnknown指针。 (4)重载了FinalConstruct,FinalRelease HRESULT COuter::FinalConstruct() { IUnknown* pUnkOuter = GetControllingUnknown(); HRESULT hRes = CoCreateInstance(CLSID_CAgg, pUnkOuter, CLSCTX_ALL, IID_IUnknown, (void**)m_pUnkAgg); return hRes; } void COuter::FinalRelease() { m_pUnkAgg.Release(); ..... } 当创建组件COuter后将会调用FinalConstruct，所以会在这里创建聚集组件。原则上聚集组件可以仅在需要的时候才创建，但也可以随着包含它的组件一起创建。聚集组件的创建没什么特别之处，只是要注意它将查??IUnknown指针，并返回给m_pUnkAgg.外部组件将通过m_pUnkAgg操作聚集组件。另外注意到使用pUnkOuter作为CoCreateInstance的参数，这将导致创建CComAggObject COuter 对象,内部包含一个CComContainedObject的包含对象。与上一节中的CComCachedTearOff类似，CComAggObject COuter 也不是从COuter派生的，所以真正的组件对象不是CComAggObject COuter 对象，而是它内部包含的CComContainedObject COuter 对象。同样pUnkOuter得到的将是CComAggO