|
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.
Comments
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
IPersistStream::Save
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
