IOleUILinkContainerA::UpdateLink-Methode (oledlg.h)

  • Artikel

Erzwingt, dass ausgewählte Links eine Verbindung mit ihrer Quelle herstellen und aktuelle Informationen abrufen.

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 werden kann. Im Dialogfeld Links aktualisieren wird dies auf FALSE festgelegt. In den Dialogfeldern Objekteigenschaften und Verknüpfungen wird der Wert 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 " der Links drückt. Rufen Sie es mit FALSE auf, wenn der Container niemals eine Fehlermeldung anzeigen sollte, d. h., wenn eine große Gruppe von Vorgängen ausgeführt wird und der Fehler später an den Benutzer zurückgegeben werden soll, wie dies bei der Statusanzeige für Updatelinks der Fall sein kann. Anstatt eine Meldung für jeden Fehler bereitzustellen, geben Sie unter der Annahme, dass Fehler vorliegen, am Ende des Vorgangs eine einzelne Meldung für alle Fehler an.

Hinweise für Implementierer

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

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 oledlg.h

Weitere Informationen

IOleObject::Update

IOleUILinkContainer