Метод 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 |
Header | objidl.h |