IPersistFile::SaveCompleted
A version of this page is also available for
4/8/2010
This method notifies the object that it can write to its file. It does this by notifying the object that it can revert from NoScribble mode (in which it must not write to its file), to Normal mode (in which it can). The component enters NoScribble mode when it receives an IPersistFile::Save call.
Syntax
HRESULT SaveCompleted(
LPCOLESTR pszFileName
);
Parameters
- pszFileName
[in] Points to the absolute path of the file where the object was previously saved.
Return Value
- S_OK
Returned in all cases.
Remarks
IPersistFile::SaveCompleted is called when a call to IPersistFile::Save is completed, and the file that was saved is now the current working file (having been saved with Save or Save As operations).
The call to Save puts the object into NoScribble mode so it cannot write to its file. When SaveCompleted is called, the object reverts to Normal mode, in which it is free to write to its file.
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Notes to Callers
OLE does not call the IPersistFile::SaveCompleted method. Typically, applications would not call it unless they are saving objects directly to files, an operation that is generally left to the user.
Requirements
| Header | objidl.h, objidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |