Структура STATSTG (objidl.h)

Статья
08/25/2023

Структура STATSTG содержит статистические данные об открытом хранилище, потоке или объекте массива байтов. Эта структура используется в интерфейсах IEnumSTATSTG, ILockBytes, IStorage и IStream .

Синтаксис

typedef struct tagSTATSTG {
  LPOLESTR       pwcsName;
  DWORD          type;
  ULARGE_INTEGER cbSize;
  FILETIME       mtime;
  FILETIME       ctime;
  FILETIME       atime;
  DWORD          grfMode;
  DWORD          grfLocksSupported;
  CLSID          clsid;
  DWORD          grfStateBits;
  DWORD          reserved;
} STATSTG;

Члены

pwcsName

Указатель на строку Юникода, завершающуюся null, которая содержит имя. Пространство для этой строки выделяется методом, который вызывается и освобождается вызывающим объектом (дополнительные сведения см. в разделе CoTaskMemFree). Чтобы не возвращать этот элемент, укажите значение STATFLAG_NONAME при вызове метода, возвращающего структуру STATSTG , за исключением вызовов IEnumSTATSTG::Next, который не позволяет указать это значение.

type

Указывает тип объекта хранилища. Это одно из значений перечисления STGTY .

cbSize

Задает размер в байтах для потока или массива байтов.

mtime

Показывает время последнего изменения хранилища, потока или массива байтов.

ctime

Показывает время создания хранилища, потока или массива байтов.

atime

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

grfMode

Указывает режим доступа, указанный при открытии объекта. Этот член действителен только в вызовах методов Stat .

grfLocksSupported

Показывает типы региональных блокировок, поддерживаемые потоком или массивом байтов. Дополнительные сведения о доступных значениях см. в перечислении LOCKTYPE . Этот элемент не используется для объектов хранилища.

clsid

Указывает идентификатор класса для объекта хранилища; Для новых объектов хранилища задано значение CLSID_NULL. Этот элемент не используется для потоков или массивов байтов.

grfStateBits

Указывает биты текущего состояния объекта хранилища; то есть значение, последнее заданное методом IStorage::SetStateBits . Этот элемент не является действительным для потоков или массивов байтов.

reserved

Зарезервировано для последующего использования.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Верхняя часть	objidl.h

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

IStorage::SetElementTimes