IPersistStreamInit::Save-Methode (ocidl.h)

Artikel
08/25/2023

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
S_OK	Die Methode wurde erfolgreich abgeschlossen.
STG_E_CANTSAVE	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.
STG_E_MEDIUMFULL	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

Weitere Informationen

IPersistStreamInit

Share via