IOleObject::IsUpToDate-Methode (oleidl.h)
Ü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 |
|---|---|
|
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 |