OleSaveToStream-Funktion (ole.h)

Artikel
08/25/2023

Speichert ein Objekt mit der IPersistStream-Schnittstelle darauf im angegebenen Stream.

Syntax

OLESTATUS OleSaveToStream(
  LPOLEOBJECT unnamedParam1,
  LPOLESTREAM unnamedParam2
);

Parameter

unnamedParam1

Zeiger auf die IPersistStream-Schnittstelle des Objekts, das im Stream gespeichert werden soll. Der pPStm-Parameter darf nicht NULL sein.

unnamedParam2

Zeiger auf die IStream-Schnittstelle des Datenstroms, in dem das Objekt gespeichert werden soll.

Rückgabewert

Diese Funktion gibt S_OK nach Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
STGMEDIUM_E_FULL	Das Objekt konnte aufgrund fehlenden Speicherplatzes nicht gespeichert werden.
OLE_E_BLANK	Der pPStm-Parameter ist NULL.

Diese Funktion kann auch alle Fehlerwerte zurückgeben, die von der WriteClassStm-Funktion oder der IPersistStream::Save-Methode zurückgegeben werden.

Hinweise

Diese Funktion vereinfacht das Speichern eines Objekts, das die IPersistStream-Schnittstelle in einem Stream implementiert. In diesem Stream ist die CLSID des Objekts den Daten vorangestellt. Wenn der Stream abgerufen wird, lässt die CLSID zu, dass der richtige Code den Daten zugeordnet wird. Die OleSaveToStream-Funktion führt Folgendes aus:

Ruft die IPersist::GetClassID-Methode auf, um die CLSID des Objekts abzurufen.
Schreibt die CLSID mit der WriteClassStm-Funktion in den Stream.
Ruft die IPersistStream::Save-Methode auf, wobei fClearDirty auf TRUE festgelegt ist, wodurch das modifiziert Bit im -Objekt gelöscht wird.

Das Begleithilfsprogramm OleLoadFromStream lädt auf diese Weise gespeicherte Objekte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ole.h (Ole2.h einschließen)
Bibliothek	Ole32.lib
DLL	Ole32.dll
APIs	ext-ms-win-com-ole32-l1-1-1 (eingeführt in Windows 8.1)

Weitere Informationen

Ipersiststream

IStream

OleLoadFromStream