Saves an object, and any nested objects that it contains, into the specified
storage object. The object is placed in NoScribble mode, and it must not write
to the specified storage until it receives a call to its IPersistStorage::SaveCompleted
| IStorage *pStgSave,
||//Pointer to storage object
| BOOL fSameAsLoad
||//Indicates whether the specified storage object is the current one
[in]Points to the storage object into which the component object is to be
[in]Indicates whether the specified storage object is the current one, which
was passed to the object by one of the following calls:
This parameter is set to FALSE when performing a Save As or Save A Copy To
operation or when performing a full save. In the latter case, this method saves to
a temporary file, deletes the original file, and renames the temporary file.
This parameter is set to TRUE to perform a full save in a low-memory situation
or to perform a fast incremental save in which only the dirty components are
The object was successfully saved.
The object was not saved because of a lack of space on the disk.
The object could not be saved due to errors other than a lack of disk space.
This method saves an object, and any nested objects it contains, into the
specified storage object. It also places the component object into NoScribble mode.
Thus, the component object cannot write to its storage object until a
subsequent call to the IPersistStorage::SaveCompleted
method returns the object to Normal mode.
If the storage object is the same as the one it was loaded or created from,
the save operation may be able to write incremental changes to the storage
object. Otherwise, a full save must be done.
This method recursively calls the IPersistStorage::Save
method, the OleSave
function, or the IStorage::CopyTo
method to save its nested objects.
This method does not call the IStorage::Commit
method. Nor does it write the class identifier to the storage object. Both of
these tasks are the responsibilities of the caller.
Notes to Callers
Rather than calling IPersistStorage::Load
directly, you typically call the OleSave
helper function which performs the following steps:
- Call the WriteClassStg function to write the class identifier for the object to the storage.
- Call the IPersistStorage::Save method.
- If needed, call the IStorage::Commit method on the storage object.
Then, a container application performs any other operations necessary to
complete the save and calls the SaveCompleted
method for each component object.
If an embedded object passed the IPersistStorage::Save
method to its nested objects, it must wait until it receives a call to its IPersistStorage::SaveCompleted
method before calling the IPersistStorage::SaveCompleted
method for its nested objects.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages