IOleLink::Update-Methode (oleidl.h)

Artikel
03/01/2024

Updates die zwischengespeicherten Daten des zusammengesetzten Dokuments für ein verknüpftes Objekt. Dies beinhaltet eine Bindung an die Linkquelle, sofern sie noch nicht gebunden ist.

Syntax

HRESULT Update(
  [in] IBindCtx *pbc
);

Parameter

[in] pbc

Ein Zeiger auf die IBindCtx-Schnittstelle im Bindungskontext, der zum Binden der Linkquelle verwendet werden soll. Dieser Parameter kann NULL sein. Der Bindungskontext zwischenspeichert Objekte, die während des Bindungsprozesses gebunden sind, enthält Parameter, die für alle Vorgänge gelten, die den Bindungskontext verwenden, und stellt die Mittel bereit, mit denen die Bindungsimplementierung Informationen zu ihrer Umgebung abrufen soll. Weitere Informationen finden Sie unter IBindCtx.

Rückgabewert

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

Rückgabecode	Beschreibung
CACHE_E_NOCACHE_UPDATE	Der Bindungsvorgang funktionierte, aber es wurden keine Caches aktualisiert.
CACHE_S_SOMECACHES_NOTUPDATED	Der Bindungsvorgang funktionierte, aber nicht alle Caches wurden aktualisiert.
OLE_E_CANT_BINDTOSOURCE	Eine Bindung an die Linkquelle kann nicht möglich sein.

Hinweise

Hinweise für Anrufer

Ihre Containeranwendung sollte Update aufrufen, wenn der Endbenutzer die zwischengespeicherten Daten für ein verknüpftes Objekt aktualisiert.

Der Endbenutzer kann die zwischengespeicherten Daten für ein verknüpftes Objekt aktualisieren, indem er im Dialogfeld Links die Schaltfläche Jetzt aktualisieren auswählt. Wenn Sie die OleUIEditLinks-Funktion zum Anzeigen des Dialogfelds Links verwenden, müssen Sie die IOleUILinkContainer-Schnittstelle implementieren. Das Dialogfeld ruft Ihre Implementierungen von IOleUILinkContainer::UpdateLink auf, wenn der Endbenutzer die Schaltfläche Jetzt aktualisieren auswäht. Ihre Implementierung dieser Methode kann Update aufrufen.

Ihre Containeranwendung kann auch Update aufrufen, um ein verknüpftes Objekt zu aktualisieren, da diese Methode Update aufruft, wenn es für ein verknüpftes Objekt aufgerufen wird.

Diese Methode aktualisiert sowohl automatische als auch manuelle Links. Bei manuellen Links ist das Aufrufen von Update oder Update die einzige Möglichkeit, die Caches zu aktualisieren. Weitere Informationen zu automatischen und manuellen Links finden Sie unter IOleLink::SetUpdateOptions.

Hinweise zur Implementierung

Wenn pbc nicht NULL ist, ruft die Implementierung von Update des verknüpften Objekts IBindCtx::RegisterObjectBound auf, um die gebundene Linkquelle zu registrieren. Dadurch wird sichergestellt, dass die Linkquelle weiterhin ausgeführt wird, bis der Bindungskontext freigegeben wird.

Die aktuellen Caches bleiben intakt, wenn die Linkquelle nicht gebunden werden kann.

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