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

Статья
02/29/2024

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

Синтаксис

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

Параметры

[in] celt

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

[out] rgelt

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

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

[in, out] pceltFetched

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

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

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

Требования

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

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

FORMATETC

IEnumFORMATETC

Share via