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