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

Статья
03/05/2024

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

Синтаксис

HRESULT Next(
  [in]      ULONG    celt,
  [out]     STATDATA *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 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	objidl.h

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

IEnumSTATDATA

STATDATA

Поделиться через