IEnumConnectionPoints::Next method

Retrieves the specified number of items in the enumeration sequence.

Syntax


HRESULT Next(
  [in]  ULONG            cConnections,
  [out] IConnectionPoint **rgpcn,
  [out] ULONG            *lpcFetched
);

Parameters

cConnections [in]

The number of items to be retrieved. If there are fewer than the requested number of items left in the sequence, this method retrieves the remaining elements.

rgpcn [out]

An array of enumerated items.

The enumerator is responsible for calling AddRef, and the caller is responsible for calling Release through each pointer enumerated. If cConnections is greater than 1, the caller must also pass a non-NULL pointer passed to lpcFetched to know how many pointers to release.

lpcFetched [out]

The number of items that were retrieved. This parameter is always less than or equal to the number of items requested.

Return value

If the method retrieves the number of items requested, the return value is S_OK. Otherwise, it is S_FALSE.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | UWP apps]

Minimum supported server

Windows 2000 Server [desktop apps | UWP apps]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

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

See also

IConnectionPoint
IEnumConnectionPoints

 

 

Show: