STATSTG-Struktur (objidl.h)

Die STATSTG-Struktur enthält statistische Daten zu einem offenen Speicher-, Stream- oder Bytearrayobjekt. Diese Struktur wird in den Schnittstellen IEnumSTATSTG, ILockBytes, IStorage und IStream verwendet.

Syntax

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;

Member

pwcsName

Ein Zeiger auf eine MIT NULL endende Unicode-Zeichenfolge, die den Namen enthält. Der Speicherplatz für diese Zeichenfolge wird von der Methode zugewiesen, die aufgerufen und vom Aufrufer freigegeben wird (weitere Informationen finden Sie unter CoTaskMemFree). Um diesen Member nicht zurückzugeben, geben Sie den STATFLAG_NONAME Wert an, wenn Sie eine Methode aufrufen, die eine STATSTG-Struktur zurückgibt, mit Ausnahme von Aufrufen von IEnumSTATSTG::Next, die keine Möglichkeit zum Angeben dieses Werts bietet.

type

Gibt den Typ des Speicherobjekts an. Dies ist einer der Werte aus der STGTY-Enumeration .

cbSize

Gibt die Größe des Streams oder Bytearrays in Bytes an.

mtime

Gibt für diesen Speicher, diesen Stream oder dieses Bytearray den Zeitpunkt der letzten Änderung an.

ctime

Gibt für diesen Speicher, diesen Stream oder dieses Bytearray den Erstellungszeitpunkt an.

atime

Gibt den Zeitpunkt des letzten Zugriffs für dieses Speicher-, Stream- oder Bytearray an.

grfMode

Gibt den Zugriffsmodus an, der beim Öffnen des Objekts angegeben wurde. Dieser Member ist nur in Aufrufen von Stat-Methoden gültig.

grfLocksSupported

Gibt die vom Stream oder Bytearray unterstützten Arten der Bereichssperrung an. Weitere Informationen zu den verfügbaren Werten finden Sie in der LOCKTYPE-Enumeration . Dieses Element wird nicht für Speicherobjekte verwendet.

clsid

Gibt den Klassenbezeichner für das Speicherobjekt an. für neue Speicherobjekte auf CLSID_NULL festgelegt. Dieses Element wird nicht für Datenströme oder Bytearrays verwendet.

grfStateBits

Gibt die aktuellen Zustandsbits des Speicherobjekts an. d. h. der Zuletzt von der IStorage::SetStateBits-Methode festgelegte Wert. Dieses Element ist für Datenströme oder Bytearrays nicht gültig.

reserved

Für die zukünftige Verwendung reserviert.

Anforderungen

Weitere Informationen

IStorage::SetElementTimes