IOleUILinkContainerW::SetLinkSource-Methode (oledlg.h)

Artikel
03/04/2024

Ändert die Quelle eines Links.

Syntax

HRESULT SetLinkSource(
  [in]  DWORD  dwLink,
  [in]  LPWSTR lpszDisplayName,
  [in]  ULONG  lenFileName,
  [out] ULONG  *pchEaten,
  [in]  BOOL   fValidateSource
);

Parameter

[in] dwLink

Containerdefinierter eindeutiger Bezeichner für einen einzelnen Link. Siehe IOleUILinkContainer::GetNextLink.

[in] lpszDisplayName

Zeiger auf eine neue Quellzeichenfolge, die analysiert werden soll.

[in] lenFileName

Länge des führenden Dateinamenteils der lpszDisplayName-Zeichenfolge . Wenn die Linkquelle nicht in einer Datei gespeichert ist, sollte lenFileName 0 sein. Rufen Sie für OLE-Links IOleLink::GetSourceDisplayName auf.

[out] pchEaten

Zeiger auf die Anzahl der Zeichen, die in lpszDisplayName erfolgreich analysiert wurden.

[in] fValidateSource

TRUE , wenn der Moniker überprüft werden soll; für OLE-Links sollte MkParseDisplayName aufgerufen werden. FALSE , wenn der Moniker nicht überprüft werden soll. Wenn möglich, sollte der Link die nicht überprüfte Quelle akzeptieren und sich selbst als nicht verfügbar markieren.

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 im Dialogfeld Quelle ändern auf, wobei fValidateSource zunächst auf TRUE festgelegt ist. Quelle ändern kann direkt oder über das Dialogfeld Links aufgerufen werden. Wenn dieser Aufruf von IOleUILinkContainer::SetLinkSource einen Fehler zurückgibt (z. B. MkParseDisplayName fehlgeschlagen, weil die Quelle nicht verfügbar war), sollten Sie eine Ungültige Linkquelle-Nachricht anzeigen, und der Benutzer sollte entscheiden können, ob die Quelle behoben werden soll. Wenn der Benutzer die Quelle korrigieren möchte, sollte der Benutzer zum Dialogfeld Quelle ändern zurückgegeben werden, wobei der ungültige Teil der Eingabezeichenfolge hervorgehoben ist. Wenn der Benutzer sich dafür entscheidet, die Quelle nicht zu reparieren, sollte IOleUILinkContainer::SetLinkSource ein zweites Mal aufgerufen werden, wobei fValidateSource auf FALSE festgelegt ist, und der Benutzer sollte zum Dialogfeld Links mit dem Link als Nicht verfügbar zurückgegeben werden.

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

IOleUILinkContainer

MkParseDisplayName

Freigeben über