ILockBytes::Stat-Methode (objidl.h)

Die Stat-Methode ruft eine STATSTG-Struktur ab, die Informationen für dieses Bytearrayobjekt enthält.

Syntax

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

Parameter

[out] pstatstg

Zeiger auf eine STATSTG-Struktur , in der diese Methode Informationen zu diesem Bytearrayobjekt platziert. Der Zeiger ist NULL , wenn ein Fehler auftritt.

[in] grfStatFlag

Gibt an, ob diese Methode den pwcsName-Member der STATSTG-Struktur über Werte aus der STATFLAG-Enumeration bereitstellen soll. Wenn die STATFLAG_NONAME angegeben wird, wird das pwcsName-Element von STATSTG nicht angegeben, wodurch ein Speicherbelegungsvorgang eingespart wird. Der andere mögliche Wert, STATFLAG_DEFAULT, gibt an, dass alle Member der STATSTG-Struktur angegeben werden.

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_OUTOFMEMORY	Die STATSTG-Struktur wurde aufgrund fehlenden Arbeitsspeichers für den Namensmember in der Struktur nicht zurückgegeben.
STG_E_ACCESSDENIED	Die STATSTG-Struktur wurde nicht zurückgegeben, da der Aufrufer keinen Zugriff auf das Bytearray hatte.
STG_E_INSUFFICIENTMEMORY	Die STATSTG-Struktur wurde aufgrund von unzureichendem Arbeitsspeicher nicht zurückgegeben.
STG_E_INVALIDFLAG	Der Wert für den grfStateFlag-Parameter ist ungültig.
STG_E_INVALIDPOINTER	Der Wert für den pStatStg-Parameter ist ungültig.

Hinweise

ILockBytes::Stat sollte Informationen zum Bytearrayobjekt in einer STATSTG-Struktur bereitstellen.

Anforderungen

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

ILockBytes – File-Based Implementierung

ILockBytes – Globale Speicherimplementierung

STATFLAG

STATSTG