Метод 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 |