IOleUILinkContainerW::UpdateLink-Methode (oledlg.h)

Artikel
08/25/2023

Erzwingt ausgewählte Links, eine Verbindung mit ihrer Quelle herzustellen und aktuelle Informationen abzurufen.

Syntax

HRESULT UpdateLink(
  [in] DWORD dwLink,
  [in] BOOL  fErrorMessage,
  [in] BOOL  fReserved
);

Parameter

[in] dwLink

Containerdefinierter eindeutiger Bezeichner für einen einzelnen Link. Container können den Zeiger auf den Containerstandort des Links für diesen Wert verwenden.

[in] fErrorMessage

Bestimmt, ob der Aufrufer (Implementierer von IOleUILinkContainer) eine Fehlermeldung anzeigen soll, wenn ein Link nicht aktualisiert wurde. Im Dialogfeld Links aktualisieren wird dies auf FALSE festgelegt. In den Dialogfeldern Objekteigenschaften und Verknüpfungen wird es auf TRUE festgelegt.

[in] fReserved

Dieser Parameter ist reserviert und muss auf FALSE festgelegt werden.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
E_ACCESSDENIED	Unzureichende Zugriffsberechtigungen.
E_FAIL	Fehler beim Vorgang.
E_INVALIDARG	Der angegebene Bezeichner ist ungültig.
E_OUTOFMEMORY	Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Hinweise für Anrufer

Rufen Sie diese Methode auf , wenn fErrorMessage auf TRUE festgelegt ist, wenn der Benutzer ausdrücklich eine Schaltfläche drückt, um einen Link zu aktualisieren, d. h. die Schaltfläche "Jetzt aktualisieren ". Rufen Sie es mit FALSE auf, wenn der Container niemals eine Fehlermeldung anzeigen soll, d. h. in fällen, in denen eine große Gruppe von Vorgängen ausgeführt wird und der Fehler später an den Benutzer weitergegeben werden soll, wie es bei der Statusanzeige für Updatelinks vorkommen kann. Anstatt eine Nachricht für jeden Fehler bereitzustellen, geben Sie eine einzelne Nachricht für alle Fehler am Ende des Vorgangs an, wenn Fehler vorliegen.

Hinweise zu Implementierern

Rufen Sie für OLE-Links IOleObject::Update auf.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oledlg.h

Weitere Informationen

IOleObject::Update

IOleUILinkContainer

Freigeben über