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


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

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

Синтаксис

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