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

Статья
08/25/2023

Метод Stat извлекает структуру STATSTG для этого потока.

Синтаксис

HRESULT Stat(
  [out] STATSTG *pstatstg,
  [in]  DWORD   grfStatFlag
);

Параметры

[out] pstatstg

Указатель на структуру STATSTG , в которой этот метод помещает сведения об этом объекте потока.

[in] grfStatFlag

Указывает, что этот метод не возвращает некоторые элементы в структуре STATSTG , тем самым сохраняя операцию выделения памяти. Значения взяты из перечисления STATFLAG .

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

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

Код возврата	Описание
S_OK	Структура STATSTG была успешно возвращена в указанном расположении.
E_PENDING	Только асинхронное хранилище. Часть или все данные потока в настоящее время недоступны.
STG_E_ACCESSDENIED	Вызывающий объект не имеет достаточных разрешений для доступа к статистике для этого объекта хранилища.
STG_E_INSUFFICIENTMEMORY	Структура STATSTG не была возвращена из-за нехватки памяти.
STG_E_INVALIDFLAG	Недопустимое значение параметра grfStateFlag .
STG_E_INVALIDPOINTER	Недопустимый указатель pStatStg .
STG_E_REVERTED	Объект был признан недействительным операцией отменить изменения над ним в дереве транзакций.

IStream::Stat получает указатель на структуру STATSTG , содержащую сведения об этом открытом потоке. Когда этот поток находится в структурированном хранилище и вызывается IStorage::EnumElements , он создает объект перечислителя с интерфейсом IEnumSTATSTG , который можно вызвать для перечисления хранилищ и потоков через структуры STATSTG , связанные с каждым из них.

Требования

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

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

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

STATFLAG

STATSTG