IOleUILinkContainerW::UpdateLink-Methode (oledlg.h)

  • Artikel

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