Метод 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

См. также раздел

IPersistStorage