Метод 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*, которая получает указатель интерфейса на новый объект перечислителя.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
| 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 |