Метод IEnumOleUndoUnits::Next (ocidl.h)
Извлекает указанное количество элементов в последовательности перечисления.
Синтаксис
HRESULT Next(
[in] ULONG cElt,
[out] IOleUndoUnit **rgElt,
[out] ULONG *pcEltFetched
);
Параметры
[in] cElt
Количество извлекаемых элементов. Если в последовательности осталось меньше запрошенного числа элементов, этот метод извлекает оставшиеся элементы.
[out] rgElt
Массив перечисляемых элементов.
Перечислитель отвечает за вызов AddRef, а вызывающий — за вызов Release через каждый перечисляемый указатель. Если значение cElt больше 1, вызывающий объект должен также передать указатель, отличный от NULL, переданный в pcEltFetched , чтобы узнать, сколько указателей необходимо освободить.
[out] pcEltFetched
Количество извлеченных элементов. Этот параметр всегда меньше или равен числу запрошенных элементов.
Возвращаемое значение
Если метод извлекает количество запрошенных элементов, возвращаемое значение будет S_OK. В противном случае это S_FALSE.
Комментарии
Вызывающий объект отвечает за вызов метода Release для каждого элемента в массиве после успешного возврата этого метода. Если cUndoUnits больше единицы, вызывающий объект также должен передать указатель, отличный от NULL, в pcFetched, чтобы получить количество указателей, которые он должен освободить.
E_NOTIMPL не допускается в качестве возвращаемого значения. Если возвращается значение ошибки, никакие записи в массиве rgpcd не являются допустимыми при выходе и не требуют выпуска.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ocidl.h |