IOleUILinkContainerA：：GetLinkSource 方法 (oledlg.h)

發行項
03/05/2024

擷取可在 [ 連結 ] 對話框中顯示之連結的相關信息。

語法

HRESULT GetLinkSource(
  [in]            DWORD dwLink,
  [out, optional] LPSTR *lplpszDisplayName,
  [out]           ULONG *lplenFileName,
  [out, optional] LPSTR *lplpszFullLinkType,
  [out, optional] LPSTR *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。其他可能的傳回值包括下列專案。

傳回碼	Description
E_ACCESSDENIED	訪問許可權不足。
E_FAIL	作業失敗。
E_INVALIDARG	指定的識別碼無效。
E_OUTOFMEMORY	此作業的記憶體不足。

備註

來電者的附註

從 [ 變更來源 ] 對話框傳回之後，在對話框初始化期間呼叫此方法。

規格需求

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