IPersistFile::SaveCompleted

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

IPersistFile::Save