IEnumObjects::Next method (shobjidl_core.h)

Gets the next specified number and type of objects.

Syntax

HRESULT Next(
  [in]            ULONG  celt,
  [in]            REFIID riid,
  [out]           void   **rgelt,
  [out, optional] ULONG  *pceltFetched
);

Parameters

[in] celt

Type: ULONG

The number of objects to retrieve.

[in] riid

Type: REFIID

Reference to the desired interface ID.

[out] rgelt

Type: void**

When this method returns, contains the interface pointer requested in riid.

[out, optional] pceltFetched

Type: ULONG*

Pointer to a ULONG value that, when this method returns, states the actual number of objects retrieved. This value can be NULL.

Return value

Type: HRESULT

Returns S_OK if the method successfully retrieved the requested objects. This method only returns S_OK if the full count of requested items are successfully retrieved.

S_FALSE indicates that more items were requested than remained in the enumeration.

Requirements