Skip to content

creating-an-aggregated-object.md

Latest commit

 

History

History
27 lines (18 loc) · 1.34 KB

creating-an-aggregated-object.md

File metadata and controls

27 lines (18 loc) · 1.34 KB
Raw
description Learn more about: Creating an Aggregated Object
title Creating an Aggregated Object
ms.date 11/04/2016
helpviewer_keywords
aggregation [C++], creating aggregated objects
aggregate objects [C++], creating
ms.assetid fc29d7aa-fd53-4276-9c2f-37379f71b179

Creating an Aggregated Object

Aggregation delegates IUnknown calls, providing a pointer to the outer object's IUnknown to the inner object.

To create an aggregated object

  1. Add an IUnknown pointer to your class object and initialize it to NULL in the constructor.

  2. Override FinalConstruct to create the aggregate.

  3. Use the IUnknown pointer, defined in Step 1, as the second parameter for the COM_INTERFACE_ENTRY_AGGREGATE macros.

  4. Override FinalRelease to release the IUnknown pointer.

Note

If you use and release an interface from the aggregated object during FinalConstruct, you should add the DECLARE_PROTECT_FINAL_CONSTRUCT macro to the definition of your class object.

See also

Fundamentals of ATL COM Objects