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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Kopfzeile | objidl.h |