Метод IStorage::Stat (objidl.h)
Метод Stat извлекает структуру STATSTG для этого открытого объекта хранилища.
Синтаксис
HRESULT Stat(
[out] STATSTG *pstatstg,
[in] DWORD grfStatFlag
);
Параметры
[out] pstatstg
При возврате указатель на структуру STATSTG , в которой этот метод помещает сведения об открытом объекте хранилища. При возникновении ошибки этот параметр имеет значение NULL .
[in] grfStatFlag
Указывает, что некоторые элементы в структуре STATSTG не возвращаются, что позволяет сохранить операцию выделения памяти. Значения взяты из перечисления STATFLAG .
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
| S_OK | Структура STATSTG была успешно возвращена в указанном расположении. |
| E_PENDING | Только асинхронное хранилище. Часть или все данные хранилища в настоящее время недоступны. |
| STG_E_ACCESSDENIED | Вызывающий объект не имеет достаточных разрешений для доступа к статистике для этого объекта хранилища. |
| STG_E_INSUFFICIENTMEMORY | Структура STATSTG не была возвращена из-за нехватки памяти. |
| STG_E_INVALIDFLAG | Недопустимое значение параметра grfStateFlag . |
| STG_E_INVALIDPARAMETER | Один из параметров был недопустимым. |
Комментарии
IStorage::Stat получает структуру STATSTG для текущего объекта хранилища. Структура STATSTG содержит статистические сведения об объекте хранилища. IStorage::EnumElements возвращает указатель на объект перечислителя. Объект перечислителя, возвращаемый этим методом, реализует интерфейс IEnumSTATSTG , через который перечисляются данные, хранящиеся в массиве структур STATSTG .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | objidl.h |
| Библиотека | Uuid.lib |
| DLL | Ole32.dll |