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