IOleUILinkContainerA：：GetLinkSource 方法 (oledlg.h)

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

語法

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。 其他可能的傳回值包括下列專案。

備註

來電者的附註

規格需求

另請參閱

IOleLink：：GetSourceDisplayName

IOleObject：：GetUserType

IOleUILinkContainer

OLEUICHANGESOURCE

OleUIChangeSource

USERCLASSTYPE