IOleLink::SetSourceDisplayName-Methode (oleidl.h)

Artikel
08/25/2023

Legt den Anzeigenamen für die Linkquelle fest.

Syntax

HRESULT SetSourceDisplayName(
  [in] LPCOLESTR pszStatusText
);

Parameter

[in] pszStatusText

Ein Zeiger auf den Anzeigenamen der neuen Linkquelle. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück.

Werte von MkParseDisplayName können auch hier zurückgegeben werden.

Hinweise

Hinweise für Anrufer

Ihre Containeranwendung kann IOleLink::SetSourceDisplayName aufrufen, wenn der Endbenutzer die Quelle eines Links ändert oder einen Link unterbricht. Beachten Sie, dass dafür das verknüpfte Objekt einen Moniker aus dem Anzeigenamen erstellen muss. Wenn Sie den Anzeigenamen lieber selbst in einen Moniker analysieren möchten, kann Ihr Container IOleLink::SetSourceMoniker anstelle von IOleLink::SetSourceDisplayName aufrufen.

Wenn Sie die OleUIEditLinks-Funktion zum Anzeigen des Dialogfelds Links verwenden, müssen Sie die IOleUILinkContainer-Schnittstelle implementieren. Das Dialogfeld ruft Ihre Implementierungen von IOleUILinkContainer::SetLinkSource und IOleUILinkContainer::CancelLink auf. Ihre Implementierung dieser Methoden kann IOleLink::SetSourceDisplayName aufrufen.

Wenn Ihre Containeranwendung sofort an eine neu angegebene Linkquelle gebunden wird, sollten Sie stattdessen MkParseDisplayName und IOleLink::SetSourceMoniker aufrufen und dann IOleLink::BindToSource mithilfe des Bindungskontexts aus dem Analysevorgang aufrufen. Durch die Wiederverwendung des Bindungskontexts können Sie das redundante Laden von Objekten vermeiden, die andernfalls auftreten könnten.

Hinweise zu Implementierern

Der Vertrag für IOleLink::SetSourceDisplayName gibt nicht an, wann das verknüpfte Objekt den Anzeigenamen in einen Moniker analysiert. Die Analyse kann erfolgen, bevor IOleLink::SetSourceDisplayName zurückgibt, oder das verknüpfte Objekt kann den Anzeigenamen speichern und nur analysieren, wenn es an die Linkquelle gebunden werden muss. Beachten Sie, dass die Analyse des Anzeigenamens möglicherweise ein kostspieliger Vorgang ist, da möglicherweise eine Bindung an die Linkquelle erforderlich ist. Die bereitgestellte Implementierung von IOleLink::SetSourceDisplayName analysiert den Anzeigenamen und gibt dann den bindungskontext frei, der im Analysevorgang verwendet wird. Dies kann dazu führen, dass der Linkquellserver ausgeführt und dann beendet wird.

Wenn das verknüpfte Objekt an die aktuelle Linkquelle gebunden ist, unterbricht die Implementierung von IOleLink::SetSourceDisplayName die Verbindung.

Weitere Informationen dazu, wie das verknüpfte Objekt den Moniker für die Linkquelle speichert und verwendet, finden Sie unter IOleLink::SetSourceMoniker.

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