OleSaveToStream-Funktion (ole2.h)
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 |
|---|---|
|
Das Objekt konnte aufgrund fehlenden Speicherplatzes nicht gespeichert werden. |
|
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.
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) |