|
IPersistStream::Save
Saves an object to the specified stream.
HRESULT Save(
IStream *pStm,
| //Pointer to the stream where the object is to be saved
| BOOL fClearDirty
| //Specifies whether to clear the dirty flag
| );
|
|
Parameters
pStm
[in]Points to the stream into which the object should be saved.
fClearDirty
[in]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.
Return Values
S_OK
The object was successfully saved to the stream.
STG_E_CANTSAVE
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 IStream::Write call returned STG_E_CANTSAVE.
STG_E_MEDIUMFULL
The object could not be saved because there is no space left on the storage
device.
Comments
This method 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 IStream::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.
Notes to Callers
Rather than calling IPersistStream::Save directly, you typically use the OleSaveToStream helper function which performs the following steps:
- Calls IPersistStream::GetClassID to get the object's class identifier.
- Calls the WriteClassStm function to write the object's class identifier to the stream.
- Calls IPersistStream::Save.
If you call these methods directly, you can write other data into the stream
after the class identifier before calling IPersistStream::Save.
The OLE-provided implementation of IPersistStream follows this same pattern.
Notes to Implementors
The IPersistStream::Save method does not write the class identifier to the stream. The caller is
responsible for writing the class identifier.
The IPersistStream::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.
See Also
IPersist::GetClassID, IStream::Write, OleSaveToStream
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
