CComDynamicUnkArray Class

This class stores an array of IUnknown pointers.

class CComDynamicUnkArray

Members

Public Constructors

Name

Description

CComDynamicUnkArray::CComDynamicUnkArray

Constructor. Initializes the collection values to NULL and the collection size to zero.

CComDynamicUnkArray::~CComDynamicUnkArray

The destructor.

Public Methods

Name

Description

CComDynamicUnkArray::Add

Call this method to add an IUnknown pointer to the array.

CComDynamicUnkArray::begin

Returns a pointer to the first IUnknown pointer in the collection.

CComDynamicUnkArray::clear

Empties the array.

CComDynamicUnkArray::end

Returns a pointer to one past the last IUnknown pointer in the collection.

CComDynamicUnkArray::GetAt

Retrieves the element at the specified index.

CComDynamicUnkArray::GetCookie

Call this method to get the cookie associated with a given IUnknown pointer.

CComDynamicUnkArray::GetSize

Returns the length of an array.

CComDynamicUnkArray::GetUnknown

Call this method to get the IUnknown pointer associated with a given cookie.

CComDynamicUnkArray::Remove

Call this method to remove an IUnknown pointer from the array.

Remarks

CComDynamicUnkArray holds a dynamically allocated array of IUnknown pointers, each an interface on a connection point. CComDynamicUnkArray can be used as a parameter to the IConnectionPointImpl template class.

The CComDynamicUnkArray methods begin and end can be used to loop through all connection points (for example, when an event is fired).

See Adding Connection Points to an Object for details on automating creation of connection point proxies.

Note

Note   The class CComDynamicUnkArray is used by the Add Class wizard when creating a control which has Connection Points. If you wish to specify the number of Connection Points manually, change the reference from CComDynamicUnkArray to CComUnkArray< n >, where n is the number of connection points required.

Requirements

Header: atlcom.h

See Also

Reference

CComUnkArray Class

Other Resources

ATL Class Overview