IStorage::Stat-Methode (objidl.h)

Artikel
08/25/2023

Die Stat-Methode ruft die STATSTG-Struktur für dieses geöffnete Speicherobjekt ab.

Syntax

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

Parameter

[out] pstatstg

Zeigen Sie bei der Rückgabe auf eine STATSTG-Struktur , in der diese Methode Informationen zum geöffneten Speicherobjekt angibt. Dieser Parameter ist NULL , wenn ein Fehler auftritt.

[in] grfStatFlag

Gibt an, dass einige member in der STATSTG-Struktur nicht zurückgegeben werden, wodurch ein Speicherbelegungsvorgang eingespart 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 Speichers 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_INVALIDPARAMETER	Einer der Parameter war ungültig.

Hinweise

IStorage::Stat ruft die STATSTG-Struktur für das aktuelle Speicherobjekt ab. Die STATSTG-Struktur enthält statistische Informationen zum Speicherobjekt. IStorage::EnumElements gibt einen Zeiger auf ein Enumeratorobjekt zurück. Das von dieser Methode zurückgegebene Enumeratorobjekt implementiert die IEnumSTATSTG-Schnittstelle , über die die im Array der STATSTG-Strukturen gespeicherten Daten aufgelistet werden.

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