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

Статья
08/25/2023

Метод 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*, которая получает указатель интерфейса на новый объект перечислителя.

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

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

Код возврата	Описание
S_OK	Объект перечислителя был успешно возвращен.
E_PENDING	Только асинхронное хранилище. Часть или все данные элемента в настоящее время недоступны.
STG_E_INSUFFICIENTMEMORY	Не удалось создать объект перечислителя из-за нехватки памяти.
STG_E_INVALIDPARAMETER	Один из параметров был недопустимым.
STG_E_REVERTED	Объект хранилища был признан недействительным в результате операции отменить изменения над ним в дереве транзакций.

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	objidl.h
Библиотека	Uuid.lib
DLL	Ole32.dll

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

IEnumSTATSTG

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

STATSTG