IOleLink::SetUpdateOptions-Methode (oleidl.h)

Artikel
03/01/2024

Gibt an, wie oft ein verknüpftes Objekt seine zwischengespeicherten Daten aktualisieren soll.

Syntax

HRESULT SetUpdateOptions(
  [in] DWORD dwUpdateOpt
);

Parameter

[in] dwUpdateOpt

Gibt an, wie oft ein verknüpftes Objekt seine zwischengespeicherten Daten aktualisieren soll. Die möglichen Werte für dwUpdateOpt stammen aus der OLEUPDATE-Enumeration.

Rückgabewert

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

Rückgabecode	Beschreibung
E_INVALIDARG	Der angegebene Wert ist ungültig.

Hinweise

Hinweise für Anrufer

Ihre Containeranwendung sollte IOleLink::SetUpdateOptions aufrufen, wenn der Endbenutzer die Updateoption für ein verknüpftes Objekt ändert.

Der Endbenutzer wählt die Updateoption für ein verknüpftes Objekt über das Dialogfeld Links aus. Wenn Sie die OleUIEditLinks-Funktion zum Anzeigen dieses Dialogfelds verwenden, müssen Sie die IOleUILinkContainer-Schnittstelle implementieren. Das Dialogfeld ruft Ihre IOleUILinkContainer::SetLinkUpdateOptions-Methode auf, um die vom Endbenutzer ausgewählte Updateoption anzugeben. Ihre Implementierung dieser Methode sollte die IOleLink::SetUpdateOptions-Methode aufrufen, um die ausgewählte Option an das verknüpfte Objekt zu übergeben.

Hinweise zu Implementierern

Die Standardupdateoption ist OLEUDPATE_ALWAYS. Die Implementierung von IPersistStorage::Save des verknüpften Objekts speichert die aktuelle Updateoption.

Wenn OLEUDPATE_ALWAYS als Updateoption angegeben ist, aktualisiert das verknüpfte Objekt die Caches des Links in den folgenden Situationen:

Wenn die Updateoption von manuell in automatisch geändert wird, wenn die Linkquelle ausgeführt wird.
Immer dann, wenn das verknüpfte Objekt an die Linkquelle gebunden wird.
Immer wenn die Linkquelle ausgeführt wird und die Implementierungen IOleObject::Close, IPersistStorage::Save oder IAdviseSink::OnSave des verknüpften Objekts aufgerufen werden.

Sowohl für manuelle als auch für automatische Links aktualisiert das verknüpfte Objekt den Cache, wenn die Containeranwendung IOleObject::Update oder IOleLink::Update aufruft.

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