IOleLink::Update-Methode (oleidl.h)
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 |
|---|---|
|
Der Bindungsvorgang funktionierte, aber es wurden keine Caches aktualisiert. |
|
Der Bindungsvorgang funktionierte, aber nicht alle Caches wurden aktualisiert. |
|
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 |