Saves an object to the specified stream.
HRESULT Save( LPSTREAM pStm, BOOL fClearDirty );
An IStream pointer to the stream into which the object should be saved.
Indicates whether to clear the dirty flag after the save is complete. If TRUE, the flag should be cleared. If FALSE, the flag should be left unchanged.
This method can return the following values.
||The method completed successfully.|
||The object could not save itself to the stream. This error could indicate, for example, that the object contains another object that is not serializable to a stream or that an ISequentialStream::Write call returned STG_E_CANTSAVE.|
||The object could not be saved because there is no space left on the storage device.|
IPersistStreamInit::Save saves an object into the specified stream and indicates whether the object should reset its dirty flag.
The seek pointer is positioned at the location in the stream at which the object should begin writing its data. The object calls the ISequentialStream::Write method to write its data.
On exit, the seek pointer must be positioned immediately past the object data. The position of the seek pointer is undefined if an error returns.
The IPersistStreamInit::Save method can read from, write to, and seek in the stream; but it must not seek to a location in the stream before that of the seek pointer on entry.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|