Метод IEnumUnknown::Next (objidl.h)

Извлекает указанное количество элементов в последовательности перечисления.

Синтаксис

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

Параметры

[in] celt

Количество извлекаемых элементов. Если в последовательности осталось меньше запрошенного числа элементов, этот метод извлекает оставшиеся элементы.

[out] rgelt

Массив перечисляемых элементов.

Перечислитель отвечает за вызов AddRef, а вызывающий — за вызов Release через каждый перечисляемый указатель. Если значение celt больше 1, вызывающий объект должен также передать указатель, отличный от NULL, переданный в pceltFetched , чтобы узнать, сколько указателей необходимо освободить.

[out] pceltFetched

Количество извлеченных элементов. Этот параметр всегда меньше или равен числу запрошенных элементов.

Возвращаемое значение

Если метод получает количество запрошенных элементов, возвращаемое значение будет S_OK. В противном случае это S_FALSE.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	objidl.h (включая ObjIdl.h)

См. также раздел

IEnumUnknown

IUnknown