IStream::Stat-Methode (objidl.h)

Die Stat-Methode ruft die STATSTG-Struktur für diesen Stream ab.

Syntax

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

Parameter

[out] pstatstg

Zeiger auf eine STATSTG-Struktur , in der diese Methode Informationen zu diesem Streamobjekt platziert.

[in] grfStatFlag

Gibt an, dass diese Methode einige Member in der STATSTG-Struktur nicht zurückgibt, wodurch ein Speicherbelegungsvorgang gespeichert wird. Werte werden aus der STATFLAG-Enumeration übernommen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Die STATSTG-Struktur wurde am angegebenen Speicherort erfolgreich zurückgegeben.
E_PENDING	Nur asynchroner Speicher: Ein Teil oder alle Daten des Datenstroms sind derzeit nicht verfügbar.
STG_E_ACCESSDENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen für den Zugriff auf Statistiken für dieses Speicherobjekt.
STG_E_INSUFFICIENTMEMORY	Die STATSTG-Struktur wurde aufgrund eines Mangels an Arbeitsspeicher nicht zurückgegeben.
STG_E_INVALIDFLAG	Der Wert für den grfStateFlag-Parameter ist ungültig.
STG_E_INVALIDPOINTER	Der pStatStg-Zeiger ist ungültig.
STG_E_REVERTED	Das Objekt wurde durch einen rückgängig machen Vorgang darüber in der Transaktionsstruktur ungültig gemacht.

Hinweise

IStream::Stat ruft einen Zeiger auf die STATSTG-Struktur ab, die Informationen zu diesem geöffneten Stream enthält. Wenn sich dieser Stream in einem strukturierten Speicher befindet und IStorage::EnumElements aufgerufen wird, wird ein Enumeratorobjekt mit der IEnumSTATSTG-Schnittstelle erstellt, die aufgerufen werden kann, um die Speicher und Datenströme über die statsTG-Strukturen aufzulisten, die den einzelnen zugeordnet sind.

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]
Zielplattform	Windows
Kopfzeile	objidl.h
Bibliothek	Uuid.lib
DLL	Ole32.dll

Weitere Informationen

IStream – Implementierung von Zusammengesetzten Dateien

STATFLAG

STATSTG