IEnumSTATPROPSTG::Next method (propidl.h)

The Next method retrieves a specified number of STATPROPSTG structures, that follow subsequently in the enumeration sequence. If fewer than the requested number of STATPROPSTG structures exist in the enumeration sequence, it retrieves the remaining STATPROPSTG structures.

Syntax

HRESULT Next(
  [in]  ULONG       celt,
  [out] STATPROPSTG *rgelt,
  [out] ULONG       *pceltFetched
);

Parameters

[in] celt

The number of STATPROPSTG structures requested.

[out] rgelt

An array of STATPROPSTG structures returned.

[out] pceltFetched

The number of STATPROPSTG structures retrieved in the rgelt parameter.

Return value

This method supports the following return values.

Return code Description
S_OK
The number of STATPROPSTG structures returned is equal to the number specified in the celt parameter.
S_FALSE
The number of STATPROPSTG structures returned is less than the number specified in the celt parameter.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header propidl.h (include Propidl.h)
Library Uuid.lib
DLL Ole32.dll