IOleUILinkContainerW：：GetLinkSource 方法 (oledlg.h)

發行項
08/25/2023

擷取可在 [ 連結 ] 對話方塊中顯示之連結的相關資訊。

語法

HRESULT GetLinkSource(
  [in]            DWORD  dwLink,
  [out, optional] LPWSTR *lplpszDisplayName,
  [out]           ULONG  *lplenFileName,
  [out, optional] LPWSTR *lplpszFullLinkType,
  [out, optional] LPWSTR *lplpszShortLinkType,
  [out]           BOOL   *lpfSourceAvailable,
  [out]           BOOL   *lpfIsSelected
);

參數

[in] dwLink

單一連結的容器定義唯一識別碼。請參閱 IOleUILinkContainer：：GetNextLink。

[out, optional] lplpszDisplayName

指標變數的位址，該變數會接收連結來源之完整顯示名稱字串的指標。 [ 連結 ] 對話方塊會釋放此字串。

[out] lplenFileName

指向 lplpszDisplayName 字串前置檔案名部分長度的指標。如果連結來源未儲存在檔案中， 則 lplenFileName 應該是 0。若為 OLE 連結，請呼叫 IOleLink：：GetSourceDisplayName。

[out, optional] lplpszFullLinkType

指標變數的位址，該變數會接收顯示在 [ 連結 ] 對話方塊底部之完整連結類型字串的指標。呼叫端會配置此字串。 [ 連結 ] 對話方塊會釋放此字串。針對 OLE 連結，這應該是完整的使用者類型名稱。使用 IOleObject：：GetUserType，為 dwFormOfType指定USERCLASSTYPE_FULL。

[out, optional] lplpszShortLinkType

指標變數的位址，該變數會接收 [ 連結 ] 對話方塊清單方塊中所顯示之簡短連結類型字串的指標。呼叫端會配置此字串。 [ 連結 ] 對話方塊會釋放此字串。對於 OLE 連結，這應該是簡短的使用者類型名稱。使用 IOleObject：：GetUserType，為 dwFormOfType指定USERCLASSTYPE_SHORT。

[out] lpfSourceAvailable

如果已知連結無法使用，則會傳回 FALSE 的指標，因為連結是某些已知但無法使用的檔。某些選項，例如 [立即更新]，會在使用者介面中停用 (灰色，) 這類情況。

[out] lpfIsSelected

變數的指標，告知 [ 編輯連結 ] 對話方塊應該在對話方塊的多重選取清單方塊中選取此連結的專案。 OleUIEditLinks 會至少呼叫這個方法一次，讓每個專案放在連結清單中。如果沒有傳回 TRUE，則第一次顯示對話方塊時，不會選取任何一個。如果全部都傳回 TRUE，則會顯示所有。也就是說，如果此連結目前是基礎檔中選取範圍的一部分，則會傳回 TRUE ，否則傳回 FALSE 。在對話方塊中會選取基礎檔中選取的任何連結;如此一來，使用者可以選取一組連結，並使用對話方塊來更新它們，或同時變更其來源 () 。

傳回值

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

傳回碼	描述
E_ACCESSDENIED	存取權限不足。
E_FAIL	作業失敗。
E_INVALIDARG	指定的識別碼無效。
E_OUTOFMEMORY	此作業的記憶體不足。

備註

來電者附注

從 [ 變更來源 ] 對話方塊傳回之後，于對話方塊初始化期間呼叫這個方法。

需求


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