IPersistStreamInit::Save-Methode (ocidl.h)
Speichert ein Objekt im angegebenen Stream.
Syntax
HRESULT Save(
[in] LPSTREAM pStm,
[in] BOOL fClearDirty
);
Parameter
[in] pStm
Ein IStream-Zeiger auf den Stream, in dem das Objekt gespeichert werden soll.
[in] fClearDirty
Gibt an, ob das Änderungsflag nach Abschluss des Speichervorgangs gelöscht werden soll. Wenn TRUE, sollte das Flag gelöscht werden. Bei FALSE sollte das Flag unverändert bleiben.
Rückgabewert
Diese Methode kann die folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Das Objekt konnte sich nicht selbst im Stream speichern. Dieser Fehler kann beispielsweise darauf hinweisen, dass das Objekt ein anderes Objekt enthält, das nicht in einen Stream serialisierbar ist, oder dass ein ISequentialStream::Write-Aufruf STG_E_CANTSAVE zurückgegeben wurde. |
|
Das Objekt konnte nicht gespeichert werden, da auf dem Speichergerät kein Speicherplatz mehr vorhanden ist. |
Hinweise
IPersistStreamInit::Save speichert ein Objekt im angegebenen Stream und gibt an, ob das Objekt sein modifiziert-Flag zurücksetzen soll.
Der Suchzeiger wird an der Position im Stream positioniert, an der das Objekt mit dem Schreiben seiner Daten beginnen soll. Das -Objekt ruft die ISequentialStream::Write-Methode auf, um seine Daten zu schreiben.
Beim Beenden muss der Suchzeiger unmittelbar hinter den Objektdaten positioniert werden. Die Position des Suchzeigers ist nicht definiert, wenn ein Fehler zurückgibt.
Hinweise zu Implementierern
Die IPersistStreamInit::Save-Methode schreibt die CLSID nicht in den Stream. Der Aufrufer ist für das Schreiben der CLSID verantwortlich.Die IPersistStreamInit::Save-Methode kann im Stream lesen, schreiben und suchen. Es darf jedoch nicht nach einer Position im Stream vor dem des Suchzeigers beim Einstieg gesucht werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ocidl.h |