Метод IEnumGUID::Next (comcat.h)

Статья
02/24/2024

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

Синтаксис

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

Параметры

[in] celt

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

[out] rgelt

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

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

[out] pceltFetched

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

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

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

Требования

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

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

IEnumGUID

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