Метод IEnumOleDocumentViews::Next (docobj.h)

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

Синтаксис

HRESULT Next(
  [in]      ULONG            cViews,
  [out]     IOleDocumentView **rgpView,
  [in, out] ULONG            *pcFetched
);

Параметры

[in] cViews

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

Если pcFetched имеет значение NULL, этот параметр должен иметь значение 1.

[out] rgpView

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

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

[in, out] pcFetched

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

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

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

Комментарии

E_NOTIMPL не допускается в качестве возвращаемого значения. Если возвращается значение ошибки, никакие записи в массиве rgpView не являются допустимыми и вызовы Release не требуются.

Требования

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

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

IEnumOleDocumentViews

IOleDocumentView