Freigeben über


IOleLink::SetUpdateOptions-Methode (oleidl.h)

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:

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

Weitere Informationen

IOleLink

IOleLink::GetUpdateOptions

IOleLink::Update

IOleObject::Update

IOleUILinkContainer

OleUIEditLinks