Метод IEnumFORMATETC::Next (objidl.h)
Извлекает указанное количество элементов в последовательности перечисления.
Синтаксис
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 |