IPersistStorage::IsDirty 方法 (objidl.h)

确定对象自上次保存到当前存储以来是否发生了更改。

语法

HRESULT IsDirty();

返回值

此方法返回S_OK指示对象已更改。 否则,返回 S_FALSE。

注解

使用此方法可确定是否应在关闭对象之前保存对象。 对象的脏标志在 IPersistStorage::Save 方法中被有条件地清除。

例如,可以优化文件保存操作,方法是为每个对象调用 IPersistStorage::IsDirty 方法,然后仅对脏的那些对象调用 IPersistStorage::Save 方法。

调用方备注

应将任何错误返回代码视为对象已更改的指示。 除非此方法显式返回S_FALSE,否则假定必须保存对象。

实施者说明

没有包含对象的 对象只是检查其脏标志以返回相应的结果。

包含一个或多个包含对象的容器必须维护一个内部脏标志,该标志在自上次保存以来任何包含的对象发生更改时设置。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 objidl.h

另请参阅

IPersistStorage