Windows API Reference

IEnumConnectionPoints Interface

The IEnumConnectionPoints interface enumerates the connection points supported by an object.

Methods

Next

Retrieves a specified number of elements in the enumeration state from the current position.
HRESULT Next([in] ULONG cConnections, [length_is(cConnections), out] LPCONNECTIONPOINT* ppCP, [out] ULONG* pcFetched);

• cConnections: The number of connection point pointers to be retrieved.
• ppCP: A pointer to an array of LPCONNECTIONPOINT pointers. Each pointer is an initialized connection point.
• pcFetched: A pointer to a count of the connection point pointers actually returned.

Skip

Advances the current position by the requested number of elements.
HRESULT Skip([in] ULONG cConnections);

• cConnections: The number of connection point pointers to skip.

Reset

Resets the enumeration sequence to the beginning.
HRESULT Reset(void);

Clone

Creates a new enumerator that contains the same enumeration state and is at the same position as the current enumerator.
HRESULT Clone([out] IEnumConnectionPoints** ppEnum);

• ppEnum: A pointer to a pointer to the new enumerator.

Remarks

An object that supports multiple outgoing interfaces implements connection points for each outgoing interface. The IEnumConnectionPoints interface is used to enumerate these connection points. The methods provided allow for iterating through the connection points, skipping elements, resetting the enumeration, and creating a copy of the enumerator.

Requirements

Header:

ocidl.h

Library:

oleaut32.lib

Interface ID:

IID_IEnumConnectionPoints