Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IPersistStream::IsDirty method

Determines whether an object has changed since it was last saved to its stream.

Syntax


HRESULT IsDirty();

Parameters

This method has no parameters.

Return value

This method returns S_OK to indicate that the object has changed. Otherwise, it returns S_FALSE.

Remarks

Use this method to determine whether an object should be saved before closing it. 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. Unless this method explicitly returns S_FALSE, assume that the object must 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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IPersistStream is defined as 00000109-0000-0000-C000-000000000046

See also

IPersistStream

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.