IOleLink::SetSourceDisplayName-Methode (oleidl.h)
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 kann 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 zu Anrufern
Ihre Containeranwendung kann IOleLink::SetSourceDisplayName aufrufen, wenn der Endbenutzer die Quelle eines Links ändert oder einen Link umbricht. Beachten Sie, dass dies erfordert, dass das verknüpfte Objekt einen Moniker aus dem Anzeigenamen erstellt. Wenn Sie lieber den Anzeigenamen 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 MkParseDisplayName und IOleLink::SetSourceMoniker stattdessen aufrufen und dann IOleLink::BindToSource mithilfe des Bindungskontexts aus dem Analysevorgang aufrufen. Durch erneutes Verwenden des Bindungskontexts können Sie das redundante Laden von Objekten vermeiden, die andernfalls auftreten können.
Hinweise zu Implementierungen
Der Vertrag für IOleLink::SetSourceDisplayName gibt nicht an, wann das verknüpfte Objekt den Anzeigenamen in einen Moniker analysiert. Die Analyse kann auftreten, bevor IOleLink::SetSourceDisplayName zurückgegeben wird, 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 potenziell ein teurer 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 beendet wird.Wenn das verknüpfte Objekt an die aktuelle Linkquelle gebunden ist, wird die Implementierung von IOleLink::SetSourceDisplayName die Verbindung umgebrochen.
Weitere Informationen dazu, wie das verknüpfte Objekt speichert und den Moniker für die Linkquelle verwendet, finden Sie unter IOleLink::SetSourceMoniker.
Anforderungen
| 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 |