可彙總

發行項
02/22/2013

指示此類別支援彙總。

[ aggregatable( 
   value
) ]

參數

值 (可省略)
參數，以指出 COM 物件可以彙總：
- 永遠不會的 COM 物件無法彙總。
- 允許可直接建立的 COM 物件，或可彙總。這是預設值。
- 總是的 COM 物件不能直接建立，並只可彙總。當您呼叫CoCreateInstance對此物件中，您必須指定彙總物件的 IUnknown 介面 (控制 IUnknown)。

備註

可集成 C++ 屬性具有相同的功能，為可集成 MIDL 屬性。這表示編譯器會將傳遞可集成透過屬性設定為產生的.idl 檔。

這個屬性不能 coclass， progid，或 vi_progid 屬性 (或另一個屬性，表示其中一種) 也會套用到相同的項目。如果使用任何的單一屬性時，會自動套用其他兩個。比方說，如果 progid 被套用的話， vi_progid 和 coclass 也會套用。

ATL 專案

如果使用 ATL 專案中使用這個屬性，屬性的行為就會變更。除了先前所說明的行為，屬性也會將加入下列的巨集的其中一個目標類別：

參數值	插入的巨集
永不	DECLARE_NOT_AGGREGATABLE
允許	DECLARE_POLY_AGGREGATABLE
永遠	DECLARE_ONLY_AGGREGATABLE

範例

// cpp_attr_ref_aggregatable.cpp
// compile with: /LD
#define _ATL_ATTRIBUTES
#include "atlbase.h"
#include "atlcom.h"

[module(name="MyModule")];

[ coclass, aggregatable(allowed),
  uuid("1a8369cc-1c91-42c4-befa-5a5d8c9d2529")]
class CMyClass {};

需求

屬性內容

適用於	類別，struct
可重複	否
必要的屬性	一或多項動作： coclass， progid，或 vi_progid。
無效的屬性	None