IOleLink：：GetSourceDisplayName 方法 (oleidl.h)

發行項
03/05/2024

擷取連結物件之連結來源的顯示名稱。

語法

HRESULT GetSourceDisplayName(
  [out] LPOLESTR *ppszDisplayName
);

參數

[out] ppszDisplayName

接收連結來源顯示名稱指標的指標變數位址。如果發生錯誤， ppszDisplayName 會設定為 NULL;否則，實作必須使用 IMalloc：：Alloc 來配置 ppszDisplayName 中傳回的字串，而呼叫端負責呼叫 IMalloc：：Free 以釋放它。呼叫端和呼叫都會使用 CoGetMalloc 傳回的配置器。

傳回值

此方法會在成功時傳回S_OK。其他可能的傳回值包括下列專案。

傳回碼	Description
E_FAIL	作業失敗。

擷取顯示名稱需要呼叫這些函式;因此，這個方法可能會傳回 CreateBindCtx 和 IMoniker：：GetDisplayName 所產生的錯誤。

備註

來電者附註

您的容器應用程式可以呼叫 IOleLink：：GetSourceDisplayName 來顯示連結的目前來源。

連結的目前來源會顯示在 [ 連結 ] 對話框中。如果您使用 OleUIEditLinks 函式來顯示 [連結 ] 對話框，則必須實作 IOleUILinkContainer 介面。對話框會呼叫 IOleUILinkContainer：：GetLinkSource 的實作，以取得它應該顯示的字串。該方法的實作可以呼叫 IOleLink：：GetSourceDisplayName。

實作者的注意事項

鏈接物件的 IOleLink：：GetSourceDisplayName 實作會呼叫 IOleLink：：GetSourceMoniker 以取得連結來源 Moniker，然後呼叫 IMoniker：：GetDisplayName 以取得該 Moniker 的顯示名稱。此作業可能很昂貴，因為它可能需要系結Moniker。所有系統提供的Moniker都可以傳回沒有系結的顯示名稱，但不保證其他Moniker實作可以。容器應用程式可以快取名稱，並在連結來源系結時更新名稱，而不是重複呼叫 IOleLink：：GetSourceDisplayName。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	oleidl.h