Метод IEnumProgressItems::Next (imapi2fs.h)

Возвращает заданное число элементов последовательности перечисления.

Синтаксис

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

Параметры

[in] celt

Количество извлекаемых элементов.

[out] rgelt

Массив интерфейсов IProgressItem . По завершении необходимо освободить каждый интерфейс в rgelt.

[out] pceltFetched

Число элементов, возвращаемых в rgelt. Если celt является одним, можно задать для pceltFetchedзначение NULL. В противном случае инициализируйте значение pceltFetched равным 0 перед вызовом этого метода.

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

S_OK возвращается, когда число запрошенных элементов (celt) возвращается успешно или количество возвращенных элементов (pceltFetched) меньше числа запрошенных элементов.

В результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата	Описание
E_POINTER	Недопустимый указатель. Значение: 0x80004003
E_OUTOFMEMORY	Не удалось выделить необходимую память. Значение: 0x8007000E
E_INVALIDARG	Один или несколько аргументов являются недопустимыми. Значение: 0x80070057

Комментарии

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	imapi2fs.h

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

IEnumProgressItems

IEnumProgressItems::RemoteNext