IOleObject::Update-Methode (oleidl.h)

  • Artikel

Updates die Daten oder Ansichtscaches eines Objekthandlers oder Linkobjekts.

Syntax

HRESULT Update();

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
E_FAIL
 Fehler beim Vorgang.
OLE_E_CANT_BINDTOSOURCE
 Das Objekt kann nicht ausgeführt werden, um aktualisierte Daten abzurufen. Das -Objekt ist für den Aufrufer aus irgendeinem Grund nicht verfügbar.
CACHE_E_NOCACHE_UPDATED
 Es wurden keine Caches aktualisiert.
CACHE_S_SOMECACHES_NOTUPDATED
 Einige Caches wurden nicht aktualisiert.

Hinweise

Die Update-Methode bietet Containern eine Möglichkeit, Daten in ihren verknüpften und eingebetteten Objekten auf dem neuesten Stand zu halten. Ein Linkobjekt kann veraltet sein, wenn die Linkquelle aktualisiert wurde. Ein eingebettetes Objekt, das Links zu anderen Objekten enthält, kann ebenfalls veraltet sein. Ein eingebettetes Objekt, das keine Links enthält, kann nicht veraltet sein, da seine Daten nicht mit einer anderen Quelle verknüpft sind.

Hinweise zu Implementierern

Wenn ein Container die IOleObject::Update-Methode eines Linkobjekts aufruft, findet das Linkobjekt die Linkquelle und ruft eine neue Präsentation daraus ab. Dieser Prozess kann auch das Ausführen einer oder mehrerer Objektanwendungen beinhalten, was zeitaufwändig sein kann.

Wenn ein Container die IOleObject::Update-Methode eines eingebetteten Objekts aufruft, fordert er das Objekt an, alle darin enthaltenen Linkobjekte zu aktualisieren. Als Antwort ruft der Objekthandler rekursiv IOleObject::Update für jedes seiner eigenen verknüpften Objekte auf und führt jedes nach Bedarf aus.

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::IsUpToDate