Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IConnectionPointContainer interface

Supports connection points for connectable objects.

When to implement

Implement this interface as part of support for connectable objects.

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

The IConnectionPointContainer interface is implemented on the connectable object to indicate the existence of the outgoing interfaces. It provides access to an enumerator sub-object with the IEnumConnectionPoints interface. It also provides access to all the connection point sub-objects, each of which implements 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.

Implement the IConnectionPointContainer interface to make a connectable object, that is, an object with outgoing interfaces.

When to use

Through IConnectionPointContainer, you can locate a specific connection point for one IID or obtain an enumerator to enumerate the connection points.

Use the IConnectionPointContainer interface as follows:

  • To obtain access to an enumerator sub-object with the IEnumConnectionPoints interface. The IEnumConnectionPoints interface can then be used to enumerate connection points for each outgoing IID.
  • To obtain access to connection point sub-objects with the IConnectionPoint interface for each outgoing IID. Through the IConnectionPoint interface, a client starts or terminates an advisory loop with the connectable object and the client's own sink. The client can also use the IConnectionPoint interface to obtain an enumerator object with the IEnumConnections interface to enumerate the connections that it knows about.


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


The IConnectionPointContainer interface has these methods.


Creates an enumerator object to iterate through all the connection points supported in the connectable object, one connection point per outgoing IID.


Returns a pointer to the IConnectionPoint interface of a connection point for a specified IID, if that IID describes a supported outgoing interface.



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


Minimum supported client

Windows 2000 Professional [desktop apps | UWP apps]

Minimum supported server

Windows 2000 Server [desktop apps | UWP apps]






IID_IConnectionPointContainer is defined as B196B284-BAB4-101A-B69C-00AA00341D07

See also




© 2018 Microsoft