IOleObject::IsUpToDate-Methode (oleidl.h)

  • Artikel

Überprüft, ob ein Objekt auf dem neuesten Stand ist.

Syntax

HRESULT IsUpToDate();

Rückgabewert

Diese Methode gibt S_OK zurück, wenn das Objekt auf dem neuesten Stand ist. andernfalls S_FALSE. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
OLE_E_UNAVAILABLE
 Die status des Objekts kann nicht rechtzeitig bestimmt werden.

Hinweise

Die IOleObject::IsUpToDate-Methode bietet Containern die Möglichkeit, rekursiv zu überprüfen, ob alle Objekte auf dem neuesten Stand sind. Das heißt, wenn der Container diese Methode für das erste Objekt aufruft, ruft das Objekt sie wiederum für alle eigenen Objekte auf, und sie wiederum für alle ihre, bis alle Objekte überprüft wurden.

Hinweise zu Implementierern

Aufgrund der rekursiven Natur von IOleObject::IsUpToDate kann die Ermittlung, ob ein Objekt veraltet ist, insbesondere eines, das ein oder mehrere andere Objekte enthält, so zeitaufwändig sein, wie das einfache Aktualisieren des Objekts überhaupt. Wenn Sie lange Abfragen dieses Typs vermeiden möchten, stellen Sie sicher, dass IOleObject::IsUpToDate OLE_E_UNAVAILABLE zurückgibt. In Fällen, in denen das abzufragende Objekt klein ist und selbst keine Objekte enthält, wodurch eine effiziente Abfrage möglich ist, kann diese Methode entweder S_OK oder S_FALSE zurückgeben.

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

Weitere Informationen

IOleObject

IOleObject::Update