Метод IStorage::EnumElements (objidl.h)

Метод EnumElements извлекает указатель на объект перечислителя, который можно использовать для перечисления объектов хранилища и потоков, содержащихся в этом объекте хранилища.

Синтаксис

HRESULT EnumElements(
  [in]  DWORD        reserved1,
  [in]  void         *reserved2,
  [in]  DWORD        reserved3,
  [out] IEnumSTATSTG **ppenum
);

Параметры

[in] reserved1

Зарезервировано для будущего использования; должно иметь значение нуль.

[in] reserved2

Зарезервировано для использования в будущем; значение должно иметь значение NULL.

[in] reserved3

Зарезервировано для будущего использования; должно иметь значение нуль.

[out] ppenum

Указатель на переменную указателя IEnumSTATSTG*, которая получает указатель интерфейса на новый объект перечислителя.

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

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

Комментарии

Объект перечислителя, возвращаемый этим методом, реализует интерфейс IEnumSTATSTG , один из стандартных интерфейсов перечислителя, который содержит методы Next, Reset, Clone и Skip . IEnumSTATSTG перечисляет данные, хранящиеся в массиве структур STATSTG .

Объект хранилища должен быть открыт в режиме чтения, чтобы разрешить перечисление его элементов.

Объект перечислителя может перечислять элементы в любом порядке. Объект перечислителя также может рассматривать перечисление как snapshot или чтобы перечисление отражало текущее состояние объекта хранилища.

Требования

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

IEnumSTATSTG

IStorage — реализация составного файла

STATSTG