Copies the current file associated with the storage object to a new file. The
new file is then used for the storage object and any uncommitted changes.
| LPOLESTR pszFile
||//Filename for the new file
Specifies the filename for the new file. It cannot be the name of an existing
file. If NULL, this method creates a temporary file with a unique name, and you
can call IStorage::Stat
to retrieve the name of the temporary file.
The file was successfully copied.
The file was not copied because of insufficient space on the storage device.
The file was not copied because the caller does not have permission to access
The file was not copied because the pszFile
pointer is invalid.
The file was not copied because the new filename (pszFile
) points to an existing file.
method copies the file associated with the storage object. An OLE container
to perform a full save on a file in a low-memory situation. Typically, this
is done only after a normal full save operation (i.e., save to temporary file,
delete original file, rename temporary file) has failed with an E_OUTOFMEMORY
It is illegal to call IRootStorage::SwitchToFile
if the storage object or anything contained within it has been marshalled to
another process. As a consequence, the container must call the IPersistStorage::HandsOffStorage
method for any element within the storage object that is loaded or running.
method forces the element to release its storage pointers and enter the
hands-off storage mode. The container must also release all pointers to streams or
storages that are contained in this root storage. After the full save operation
is completed, the container returns the contained elements to normal storage
Notes to Implementors
If you are implementing your own storage objects, the IRootStorage
methods (including QueryInterface
, and IUnknown::Release
) must not consume additional memory or file handles.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages