IPersistStreamInit::IsDirty-Methode (ocidl.h)

  • Artikel

Bestimmt, ob sich ein Objekt geändert hat, seit es zuletzt in seinem Stream 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 IPersistStreamInit::Save-Methode bedingt gelöscht.

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.

Beachten Sie, dass die von OLE bereitgestellten Implementierungen der IPersistStreamInit::IsDirty-Methode in den von OLE bereitgestellten Monikerschnittstellen immer S_FALSE zurückgeben, da sich ihr interner Zustand nie ändert.

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 ocidl.h

Weitere Informationen

IPersistStreamInit