CComPolyObject 類別

這個類別會實作彙總或 nonaggregated 物件的 IUnknown 。

template<
   class contained 
>
class CComPolyObject : public IUnknown, public CComObjectRootEx
   < contained::_ThreadModel::ThreadModelNoCS >

參數

• contained
  您的類別，衍生自 CComObjectRoot 或 CComObjectRootEx，以及從任何其他介面在物件要支援。

Members

公用建構函式

名稱	描述
CComPolyObject::CComPolyObject	建構函式。
CComPolyObject::~CComPolyObject	解構函式。

公用方法

名稱	描述
CComPolyObject::AddRef	將物件的參考計數。
CComPolyObject::CreateInstance	(靜態) 可讓您建立新的 CComPolyObject< contained> 物件，而不需額外負荷 CoCreateInstance()。
CComPolyObject::FinalConstruct	執行 m_contained的最後的初始化。
CComPolyObject::FinalRelease	執行 m_contained的最終解構。
CComPolyObject::QueryInterface	擷取指標所要求的介面。
CComPolyObject::Release	將物件的參考計數遞減。

公用資料成員

名稱	描述
CComPolyObject::m_contained	委派 IUnknown 呼叫外部 UNKNOWN，如果物件彙總或物件的 IUnknown 物件是否不可彙總。

備註

彙總的 nonaggregated 或物件的CComPolyObject 實作 IUnknown 。

當 CComPolyObject 建立的執行個體時，這個外部未知的值進行檢查。 如果是 NULL， IUnknown 為 nonaggregated 物件上實作。 如果這個外部未知的參數不是 NULL， IUnknown 為彙總的物件上實作。

使用 CComPolyObject 的優點是您不會處理 CComAggObject 和的 CComObject 於模組彙總和 nonaggregated 情況。 單一 CComPolyObject 物件控制代碼兩種情況。 這表示只有一個複本的 vtable 和函式的一個複本存在於模組。 如果您 vtable 非常大，所以可以大幅降低模組大小。 不過，因此，如果您 vtable 很小，使用 CComPolyObject 可能造成更大的模組大小，因為它沒有為彙總或 nonaggregated 最佳化物件，就像 CComAggObject 和 CComObject。

如果 DECLARE_POLY_AGGREGATABLE 巨集會在您的物件類別定義中指定， CComPolyObject 將用來建立您自己的物件。 如果您使用 ATL 專案精靈建立完整的控制項或 Internet Explorer 控制項，DECLARE_POLY_AGGREGATABLE 會自動宣告。

如果彙總， CComPolyObject 物件都有自己的 IUnknown，不同於外部物件的 IUnknown，並保留它的參考計數。 CComPolyObject 使用 CComContainedObject 委派至外部未知。

如需集合的詳細資訊，請參閱本文 ATL COM 物件的基本概念。

繼承階層架構

CComObjectRootBase

CComObjectRootEx

IUnknown

CComPolyObject

需求

Header: atlcom.h

請參閱

參考

CComObjectRootEx 類別

DECLARE_POLY_AGGREGATABLE

其他資源

ATL 類別概觀