IStorage-Schnittstelle (objidl.h)

Die IStorage-Schnittstelle unterstützt die Erstellung und Verwaltung von strukturierten Speicherobjekten. Der strukturierte Speicher ermöglicht das hierarchische Speichern von Informationen in einer einzelnen Datei und wird häufig als "Dateisystem in einer Datei" bezeichnet. Elemente eines strukturierten Speicherobjekts sind Speicher und Datenströme. Speicher sind analog zu Verzeichnissen und Datenströme analog zu Dateien. Innerhalb eines strukturierten Speichers befindet sich ein primäres Speicherobjekt, das unter Umständen unter Umständen geschachtelte Unterspeicher und Streams enthalten kann. Speicher stellen die Struktur des -Objekts bereit, und Streams enthalten die Daten, die über die IStream-Schnittstelle bearbeitet werden.

Die IStorage-Schnittstelle bietet Methoden zum Erstellen und Verwalten des Stammspeicherobjekts, untergeordneter Speicherobjekte und Streamobjekte. Diese Methoden können die Elemente im Speicherobjekt erstellen, öffnen, aufzählen, verschieben, kopieren, umbenennen oder löschen.

Eine Anwendung muss ihre IStorage-Zeiger freigeben, wenn sie mit dem Speicherobjekt ausgeführt wird, um den verwendeten Arbeitsspeicher zu verwalten. Es gibt auch Methoden zum Ändern des Datums und der Uhrzeit eines Elements.

Es gibt eine Reihe verschiedener Modi, in denen ein Speicherobjekt und seine Elemente geöffnet werden können, die durch Festlegen von Werten aus STGM-Konstanten bestimmt werden. Ein Aspekt dabei ist, wie Änderungen festgelegt werden. Sie können den direkten Modus festlegen, in dem Änderungen an einem Objekt sofort in dieses geschrieben werden, oder den Transaktionsmodus, in dem Änderungen bis zum expliziten Commit in einen Puffer geschrieben werden. Die IStorage-Schnittstelle bietet Methoden zum Commit von Änderungen und zum Wiederherstellen auf die zuletzt zugesagte Version. Beispielsweise kann ein Stream im schreibgeschützten Modus oder im Lese-/Schreibmodus geöffnet werden. Weitere Informationen finden Sie unter STGM-Konstanten.

Andere Methoden ermöglichen den Zugriff auf Informationen zu einem Speicherobjekt und seinen Elementen über die STATSTG-Struktur .

Vererbung

Die IStorage-Schnittstelle erbt von der IUnknown-Schnittstelle . IStorage verfügt auch über folgende Arten von Membern:

Methoden

Die IStorage-Schnittstelle verfügt über diese Methoden.

IStorage::Commit Die Commit-Methode stellt sicher, dass alle Änderungen, die an einem im Transaktionsmodus geöffneten Speicherobjekt vorgenommen werden, im übergeordneten Speicher widergespiegelt werden.
IStorage::CopyTo Kopiert den gesamten Inhalt eines geöffneten Speicherobjekts in ein anderes Speicherobjekt.
IStorage::CreateStorage Erstellt ein neues Speicherobjekt, das in diesem Speicherobjekt geschachtelt ist, und öffnet es mit dem angegebenen Namen im angegebenen Zugriffsmodus.
IStorage::CreateStream Erstellt und öffnet ein Streamobjekt mit dem angegebenen Namen, der in diesem Speicherobjekt enthalten ist.
IStorage::D estroyElement Entfernt den angegebenen Speicher oder Stream aus diesem Speicherobjekt.
IStorage::EnumElements Die EnumElements-Methode ruft einen Zeiger auf ein Enumeratorobjekt ab, das zum Auflisten der in diesem Speicherobjekt enthaltenen Speicher- und Streamobjekte verwendet werden kann.
IStorage::MoveElementTo Die MoveElementTo-Methode kopiert oder verschiebt einen Unterspeicher oder Stream aus diesem Speicherobjekt in ein anderes Speicherobjekt.
IStorage::OpenStorage Öffnet ein vorhandenes Speicherobjekt mit dem angegebenen Namen im angegebenen Zugriffsmodus.
IStorage::OpenStream Öffnet ein vorhandenes Streamobjekt in diesem Speicherobjekt im angegebenen Zugriffsmodus.
IStorage::RenameElement Die RenameElement-Methode benennt den angegebenen Unterspeicher oder Stream in diesem Speicherobjekt um.
IStorage::Revert Die Revert-Methode verwirft alle Änderungen, die seit dem letzten Commitvorgang am Speicherobjekt vorgenommen wurden.
IStorage::SetClass Die SetClass-Methode weist diesem Speicherobjekt den angegebenen Klassenbezeichner (CLSID) zu.
IStorage::SetElementTimes Die SetElementTimes-Methode legt die Änderungs-, Zugriffs- und Erstellungszeiten des angegebenen Speicherelements fest, wenn das zugrunde liegende Dateisystem diese Methode unterstützt.
IStorage::SetStateBits Die SetStateBits-Methode speichert bis zu 32 Bits an Zustandsinformationen in diesem Speicherobjekt.
IStorage::Stat Die Stat-Methode ruft die STATSTG-Struktur für dieses offene Speicherobjekt ab.

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

Weitere Informationen

EnumAll-Beispiel

Beispiele