IPersistStorage::IsDirty-Methode (objidl.h)

  • Artikel

Bestimmt, ob sich ein Objekt geändert hat, seit es zuletzt im aktuellen Speicher gespeichert wurde.

Syntax

HRESULT IsDirty();

Rückgabewert

Diese Methode gibt S_OK zurück, um anzugeben, dass sich das Objekt geändert hat. Andernfalls wird „S_FALSE“ zurückgegeben.

Hinweise

Verwenden Sie diese Methode, um zu bestimmen, ob ein Objekt vor dem Schließen gespeichert werden soll. Das modifiziert-Flag für ein Objekt wird in der IPersistStorage::Save-Methode bedingt gelöscht.

Sie können beispielsweise einen Dateispeichervorgang optimieren, indem Sie die IPersistStorage::IsDirty-Methode für jedes Objekt aufrufen und dann die IPersistStorage::Save-Methode nur für die Objekte aufrufen, die modifiziert sind.

Hinweise für Anrufer

Sie sollten alle Fehlerrückgabecodes als Hinweis darauf behandeln, dass sich das Objekt geändert hat. Sofern diese Methode nicht explizit S_FALSE zurückgibt, wird davon ausgegangen, dass das Objekt gespeichert werden muss.

Hinweise für Implementierer

Ein Objekt ohne enthaltene Objekte überprüft einfach sein modifiziert Flag, um das entsprechende Ergebnis zurückzugeben.

Ein Container mit einem oder mehreren enthaltenen Objekten muss ein internes modifiziert-Flag beibehalten, das festgelegt wird, wenn sich eines seiner enthaltenen Objekte seit dem letzten Speichern geändert hat.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objidl.h

Weitere Informationen

IPersistStorage