Метод IEnumFullIDList::Next (shobjidl_core.h)

Извлекает указанное количество IDLIST_ABSOLUTE элементов.

Синтаксис

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

Параметры

[in] celt

Тип: ULONG

Количество элементов, на которые ссылается массив, на который ссылается параметр rgelt .

[out] rgelt

Тип: PIDLIST_ABSOLUTE*

При успешном выполнении содержит массив PIDL. Реализация должна выделить эти идентификаторы элементов с помощью CoTaskMemAlloc. Вызывающее приложение отвечает за освобождение идентификаторов элементов с помощью CoTaskMemFree.

[out] pceltFetched

Тип: ULONG*

При успешном выполнении содержит указатель на значение, которое получает количество абсолютных идентификаторов элементов, фактически возвращенных в rgelt. Число может быть меньше значения, указанного в параметре celt . Этот параметр может иметь значение NULL для записи, только если значение celt равно 1, так как в этом случае метод может получить только один (S_OK) или ноль (S_FALSE) элементов.

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

Тип: HRESULT

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

S_FALSE указывает, что было запрошено больше элементов, чем осталось в перечислении. Значение, на которое указывает параметр pceltFetched , указывает фактическое количество извлеченных элементов. Обратите внимание, что значение будет равно 0, если больше нет элементов для извлечения.

В противном случае возвращает определенное COM-значение ошибки.

Требования