Поделиться через


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

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