IPersistStream::IsDirty
Checks the
object for changes since it was last saved.
HRESULT
IsDirty(void);
Return Values
S_OK
The object
has changed since it was last saved.
S_FALSE
The object has
not changed since the last save.
Remarks
This method
checks whether an object has changed since it was last saved so you can avoid
losing information in objects that have not yet been saved. The dirty flag for
an object is conditionally cleared in the IPersistStream::Save method.
Notes to Callers
You should
treat any error return codes as an indication that the object has changed. In
other words, unless this method explicitly returns S_FALSE, you must assume
that the object needs to be saved.
Note that the
OLE-provided implementations of the IPersistStream::IsDirty method in
the OLE-provided moniker interfaces always return S_FALSE because their
internal state never changes.
See Also