IEnumConnectionPoints interface

Enumerates connection points.

When to implement

To support connectable objects, you need to implement four related interfaces:

• IConnectionPointContainer
• IEnumConnectionPoints
• IConnectionPoint
• IEnumConnections

The IConnectionPointContainer interface indicates the existence of the outgoing interfaces. It provides access to an enumerator sub-object with the IEnumConnectionPoints interface. It also provides a connection point sub-object with the IConnectionPoint interface. The IConnectionPoint interface provides access to an enumerator sub-object with the IEnumConnections interface.

Each connection point is a separate sub-object to avoid circular reference counting problems.

A connectable object can be asked to enumerate its supported connection points through IConnectionPointContainer::EnumConnectionPoints. The resulting enumerator returned from this method implements the interface IEnumConnectionPoints, through which a client can access all the individual connection point sub-objects supported within the connectable object itself, where each connection point implements IConnectionPoint.

When enumerating connections through IEnumConnectionPoints, the enumerator is responsible for calling AddRef and the caller is responsible for calling Release when those pointers are no longer needed.

When to use

Use the IEnumConnectionPoints interface to enumerate the supported connection points for each outgoing IID.

Members

The IEnumConnectionPoints interface inherits from the IUnknown interface. IEnumConnectionPoints also has these types of members:

• Methods

Methods

The IEnumConnectionPoints interface has these methods.

Remarks

Connectable objects support the following features:

• Outgoing interfaces, such as event sets
• The ability to enumerate the IIDs of the outgoing interfaces
• The ability to connect and disconnect sinks to the object for those outgoing IIDs
• The ability to enumerate the connections that exist to a particular outgoing interface

Requirements

See also

IConnectionPoint

IConnectionPointContainer

IEnumConnections