OleSaveToStream-Funktion (ole2.h)

Artikel
03/06/2024

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

Syntax

HRESULT OleSaveToStream(
  [in] LPPERSISTSTREAM pPStm,
  [in] LPSTREAM        pStm
);

Parameter

[in] pPStm

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

[in] pStm

Zeiger auf die IStream-Schnittstelle für den Stream, in dem das Objekt gespeichert werden soll.

Rückgabewert

Diese Funktion gibt bei Erfolg S_OK 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 einen der 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 geht die CLSID des Objekts den Daten voran. 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 objekte, die auf diese Weise gespeichert wurden.

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	ole2.h (einschließlich Ole2.h)
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

Share via