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

Статья
08/26/2023

Возвращает массив из одного или нескольких интерфейсов IShellItem из перечисления .

Синтаксис

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

Параметры

[in] celt

Тип: ULONG

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

[out] rgelt

Тип: IShellItem**

Адрес массива указателей на интерфейсы IShellItem , которые получают перечисленные элементы или элементы. Вызывающее приложение отвечает за освобождение интерфейсов IShellItem путем вызова метода IUnknown::Release .

[out] pceltFetched

Тип: ULONG*

Указатель на значение, которое получает количество успешно извлеченных интерфейсов IShellItem . Число может быть меньше значения, указанного в параметре celt . Этот параметр может иметь значение NULL для записи, только если celt имеет значение one, так как в этом случае метод может получить только один элемент и вернуть S_OK или ноль элементов и вернуть S_FALSE.

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

Тип: HRESULT

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Значение , если был получен хотя бы интерфейс IShellItem .
S_FALSE	Значение , если в перечислении больше нет интерфейсов IShellItem .
	Возвращает значение ошибки, если функция завершается сбоем по какой-либо другой причине.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)

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

IEnumShellItems

IShellItem

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