Share via

Método IPersistStorage::IsDirty (objidl.h)

  • Artículo

Determina si un objeto ha cambiado desde que se guardó por última vez en su almacenamiento actual.

Sintaxis

HRESULT IsDirty();

Valor devuelto

Este método devuelve S_OK para indicar que el objeto ha cambiado. De lo contrario, devuelve S_FALSE.

Comentarios

Use este método para determinar si se debe guardar un objeto antes de cerrarlo. La marca desfasada de un objeto se borra condicionalmente en el método IPersistStorage::Save .

Por ejemplo, podría optimizar una operación de guardado de archivos llamando al método IPersistStorage::IsDirty para cada objeto y, a continuación, llamando al método IPersistStorage::Save solo para los objetos que están sucios.

Notas a los autores de llamadas

Debe tratar los códigos de devolución de error como indicación de que el objeto ha cambiado. A menos que este método devuelva explícitamente S_FALSE, suponga que el objeto debe guardarse.

Notas para los implementadores

Un objeto sin objetos contenidos simplemente comprueba su marca desfasada para devolver el resultado adecuado.

Un contenedor con uno o varios objetos contenidos debe mantener una marca desfasada interna que se establece cuando cualquiera de sus objetos contenidos ha cambiado desde que se guardó por última vez.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado objidl.h

Consulte también

IPersistStorage