Home Library Learn Samples Downloads Support Community Forums
MSDN Library
Development Tools and Languages
Visual Studio 2012
Visual C++
MFC and ATL
ATL COM Desktop Components
Macros
ATL Macros Alphabetical Reference
_ATL_ALL_WARNINGS
_ATL_APARTMENT_THREADED
_ATL_CSTRING_EXPLICIT_CONSTRUCTORS
_ATL_DEBUG_INTERFACES
_ATL_DEBUG_QI
_ATL_ENABLE_PTM_WARNING
_ATL_FREE_THREADED
_ATL_MIXED
_ATL_MULTI_THREADED
_ATL_NO_AUTOMATIC_NAMESPACE
_ATL_NO_COM_SUPPORT
_ATL_NO_VARIANT_THROW
_ATL_SECURE_NO_WARNINGS
_ATL_SINGLE_THREADED
_ATL_STATIC_REGISTRY
_ATLCATCH
_ATLCATCHALL
_ATLTRY
ATL_ESC Flags
ALT_MSG_MAP
ATL and MFC String Conversion Macros
ATL_NO_VTABLE
ATL_NOINLINE
ATL_URL Flags
ATL_URL_SCHEME
ATL_WORKER_THREAD_WAIT
ATLASSERT
ATLENSURE
ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT
ATLS_DEFAULT_THREADSPERPROC
ATLSMTP_QPENCODE Flags
ATLSMTP_UUENCODE Flags
ATLTRACE
ATLTRACE2
ATLTRACENOTIMPL
BEGIN_CATEGORY_MAP
BEGIN_COM_MAP
BEGIN_CONNECTION_POINT_MAP
BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP
BEGIN_MSG_MAP
BEGIN_PROP_MAP
BEGIN_RDX_MAP
BEGIN_SERVICE_MAP
BEGIN_SINK_MAP
BEGIN_SNAPINTOOLBARID_MAP
CHAIN_MSG_MAP
CHAIN_MSG_MAP_ALT
CHAIN_MSG_MAP_ALT_MEMBER
CHAIN_MSG_MAP_DYNAMIC
CHAIN_MSG_MAP_MEMBER
COM_INTERFACE_ENTRY
COM_INTERFACE_ENTRY Macros
COM_INTERFACE_ENTRY_AGGREGATE
COM_INTERFACE_ENTRY_AGGREGATE_BLIND
COM_INTERFACE_ENTRY_AUTOAGGREGATE
COM_INTERFACE_ENTRY_AUTOAGGREGATE_BLIND
COM_INTERFACE_ENTRY_BREAK
COM_INTERFACE_ENTRY_CACHED_TEAR_OFF
COM_INTERFACE_ENTRY_CHAIN
COM_INTERFACE_ENTRY_FUNC
COM_INTERFACE_ENTRY_FUNC_BLIND
COM_INTERFACE_ENTRY_IID
COM_INTERFACE_ENTRY_NOINTERFACE
COM_INTERFACE_ENTRY_TEAR_OFF
COM_INTERFACE_ENTRY2
COM_INTERFACE_ENTRY2_IID
COMMAND_CODE_HANDLER
COMMAND_HANDLER
COMMAND_ID_HANDLER
COMMAND_RANGE_CODE_HANDLER
COMMAND_RANGE_HANDLER
CONNECTION_POINT_ENTRY
DECLARE_AGGREGATABLE
DECLARE_CLASSFACTORY
DECLARE_CLASSFACTORY_AUTO_THREAD
DECLARE_CLASSFACTORY_EX
DECLARE_CLASSFACTORY_SINGLETON
DECLARE_CLASSFACTORY2
DECLARE_EMPTY_MSG_MAP
DECLARE_GET_CONTROLLING_UNKNOWN
DECLARE_LIBID
DECLARE_NO_REGISTRY
DECLARE_NOT_AGGREGATABLE
DECLARE_OBJECT_DESCRIPTION
DECLARE_OLEMISC_STATUS
DECLARE_ONLY_AGGREGATABLE
DECLARE_POLY_AGGREGATABLE
DECLARE_PROTECT_FINAL_CONSTRUCT
DECLARE_REGISTRY
DECLARE_REGISTRY_APPID_RESOURCEID
DECLARE_REGISTRY_RESOURCE
DECLARE_REGISTRY_RESOURCEID
DECLARE_VIEW_STATUS
DECLARE_WND_CLASS
DECLARE_WND_CLASS_EX
DECLARE_WND_SUPERCLASS
DEFAULT_REFLECTION_HANDLER
DEVMODE and TEXTMETRIC String Conversion Macros
END_CATEGORY_MAP
END_COM_MAP
END_CONNECTION_POINT_MAP
END_EXTENSION_SNAPIN_NODEINFO_MAP
END_MSG_MAP
END_PROP_MAP
END_RDX_MAP
END_SERVICE_MAP
END_SINK_MAP
END_SNAPINTOOLBARID_MAP
EXTENSION_SNAPIN_DATACLASS
EXTENSION_SNAPIN_NODEINFO_ENTRY
FORWARD_NOTIFICATIONS
IMPLEMENTED_CATEGORY
MESSAGE_HANDLER
MESSAGE_RANGE_HANDLER
NOTIFY_CODE_HANDLER
NOTIFY_HANDLER
NOTIFY_ID_HANDLER
NOTIFY_RANGE_CODE_HANDLER
NOTIFY_RANGE_HANDLER
OBJECT_ENTRY_AUTO
OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO
PROP_DATA_ENTRY
PROP_ENTRY_INTERFACE
PROP_ENTRY_INTERFACE_CALLBACK
PROP_ENTRY_INTERFACE_CALLBACK_EX
PROP_ENTRY_INTERFACE_EX
PROP_ENTRY_TYPE
PROP_ENTRY_TYPE_EX
PROP_PAGE
RDX_BINARY
RDX_CSTRING_TEXT
RDX_DWORD
RDX_TEXT
REFLECT_NOTIFICATIONS
REFLECTED_COMMAND_CODE_HANDLER
REFLECTED_COMMAND_HANDLER
REFLECTED_COMMAND_ID_HANDLER
REFLECTED_COMMAND_RANGE_CODE_HANDLER
REFLECTED_COMMAND_RANGE_HANDLER
REFLECTED_NOTIFY_CODE_HANDLER
REFLECTED_NOTIFY_HANDLER
REFLECTED_NOTIFY_ID_HANDLER
REFLECTED_NOTIFY_RANGE_CODE_HANDLER
REFLECTED_NOTIFY_RANGE_HANDLER
REQUIRED_CATEGORY
SERVICE_ENTRY
SERVICE_ENTRY_CHAIN
SINK_ENTRY
SINK_ENTRY_EX
SINK_ENTRY_INFO
SNAPINMENUID
SNAPINTOOLBARID_ENTRY
WM_FORWARDMSG
Expand Minimize
This topic has not yet been rated - Rate this topic

DECLARE_ONLY_AGGREGATABLE

Visual Studio 2012

Specifies that your object must be aggregated.

Copy 
DECLARE_ONLY_AGGREGATABLE( 
   x  
)
x

[in] The name of the class object you are defining as only aggregatable.

DECLARE_ONLY_AGGREGATABLE causes an error (E_FAIL) if an attempt is made to CoCreate your object as nonaggregated object.

By default, CComCoClass contains the DECLARE_AGGREGATABLE macro, which specifies that your object can be aggregated. To override this default behavior, include DECLARE_ONLY_AGGREGATABLE in your class definition.

C++
Copy 
class ATL_NO_VTABLE COnlyAggClass :
   public CComObjectRoot,
   public CComCoClass<COnlyAggClass, &CLSID_OnlyAggClass>
{
public:
   COnlyAggClass()
   {
   }

   DECLARE_ONLY_AGGREGATABLE(COnlyAggClass)
};

Header: atlcom.h

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.