Share via

IEnumConnectionPoints::Next

  • Article

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.

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 Values

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

OS Versions: Windows CE 3.0 and later.
Header: Ocidl.h, Ocidl.idl.
Link Library: Ole32.lib, Uuid.lib.

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.