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