IOleUILinkContainerA::SetLinkSource-Methode (oledlg.h)

Artikel
08/25/2023

Ändert die Quelle eines Links.

Syntax

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR 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 die 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	Unzureichender Arbeitsspeicher für diesen Vorgang.

Hinweise

Hinweise für Anrufer

Rufen Sie diese Methode über das Dialogfeld Quelle ändern auf, wobei fValidateSource anfänglich 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-Meldung anzeigen, und der Benutzer sollte entscheiden können, ob die Quelle korrigiert werden soll. Wenn der Benutzer die Quelle korrigiert, sollte der Benutzer zum Dialogfeld Quelle ändern mit hervorgehobenem ungültigen Teil der Eingabezeichenfolge zurückgegeben werden. Wenn der Benutzer sich dafür entscheidet, die Quelle nicht zu korrigieren, 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


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