IOleLink：：SetSourceDisplayName 方法 (oleidl.h)
設定連結來源的顯示名稱。
語法
HRESULT SetSourceDisplayName(
[in] LPCOLESTR pszStatusText
);
參數
[in] pszStatusText
新連結來源之顯示名稱的指標。 此參數不可為 NULL。
傳回值
此方法會在成功時傳回S_OK。
您也可以在這裡傳回 來自 MkParseDisplayName 的值。
備註
來電者的附註
當終端使用者變更連結的來源或中斷連結時，您的容器應用程式可以呼叫 IOleLink：：SetSourceDisplayName 。 請注意，這需要連結的對象從顯示名稱建立Moniker。 如果您想要自行將顯示名稱剖析成Moniker，您的容器可以呼叫 IOleLink：：SetSourceMoniker ，而不是 IOleLink：：SetSourceDisplayName。如果您使用 OleUIEditLinks 函式來顯示 [ 連結 ] 對話框，則必須實作 IOleUILinkContainer 介面。 對話框會呼叫 IOleUILinkContainer：：SetLinkSource 和 IOleUILinkContainer：：CancelLink 的實作。 這些方法的實作可以呼叫 IOleLink：：SetSourceDisplayName。
如果您的容器應用程式立即系結至新指定的連結來源，您應該改為呼叫 MkParseDisplayName 和 IOleLink：：SetSourceMoniker ，然後使用剖析作業的系結內容呼叫 IOleLink：：BindToSource 。 藉由重複使用系結內容，您可以避免重複載入可能發生的物件。
實作者的注意事項
IOleLink：：SetSourceDisplayName 的合約不會指定連結對象將顯示名稱剖析成 Moniker 時。 剖析可以在 IOleLink：：SetSourceDisplayName 傳 回之前發生，或者連結的物件可以儲存顯示名稱，並且只有在需要系結至連結來源時才剖析它。 請注意，剖析顯示名稱可能是昂貴的作業，因為它可能需要系結至連結來源。 提供的 IOleLink：：SetSourceDisplayName 實作會剖析顯示名稱，然後釋放剖析作業中使用的系結內容。 這可能會導致執行，然後停止鏈接來源伺服器。如果鏈接的物件系結至目前的鏈接來源， IOleLink：：SetSourceDisplayName 的實作會中斷連線。
如需連結物件如何儲存和使用Moniker至連結來源的詳細資訊，請參閱 IOleLink：：SetSourceMoniker。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | oleidl.h |