IEnumConnectionPoints::Next

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method enumerates the next cConnections elements (IConnectionPoint pointers) in the enumerator's list, returning them in rgpcn along with the actual number of enumerated elements in pcFetched.

The enumerator calls IConnectionPoint::AddRef for each returned pointer in rgpcn, and the caller is responsible for calling IConnectionPoint::Release through each pointer when those pointers are no longer needed.

Syntax

HRESULT Next(
  ULONG cConnections, 
  IConnectionPoint** rgpcn, 
  ULONG* pcFetched 
);

Parameters

• cConnections
  [in] Number of IConnectionPoint values returned in rgpcn array.

• rgpcn
  [out] Array to receive enumerated connection points.

• pcFetched
  [out] Pointer to the actual number of connection points returned in rgpcn array.

Return Value

S_OK if the number of elements supplied is cConnections; S_FALSE otherwise.

Remarks

E_NOTIMPL is not allowed as a return value.

If an error value is returned, no entries in the rgpcn array are valid on exit and require no release.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements