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 |