Expand Minimize

IEnumConnectionPoints interface

Enumerates connection points.

When to implement

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

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

The IEnumConnectionPoints interface has these methods.

MethodDescription
Clone

Creates a new enumerator that contains the same enumeration state as the current one.

Next

Retrieves the specified number of items in the enumeration sequence.

Reset

Resets the enumeration sequence to the beginning.

Skip

Skips over the specified number of items in the enumeration sequence.

 

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

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IEnumConnectionPoints is defined as B196B285-BAB4-101A-B69C-00AA00341D07

See also

IConnectionPoint
IConnectionPointContainer
IEnumConnections

 

 

Community Additions

ADD
Show:
© 2014 Microsoft