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

Статья
03/05/2024

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

Синтаксис

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

Параметры

[in] celt

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

[out] rgelt

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

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

[out] pceltFetched

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

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

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

Требования

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

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

IEnumString

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