Método IPersistStorage::IsDirty (objidl.h)
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 |