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

Статья
08/25/2023

Метод 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