共用方式為

OleCreateLinkToFile 函式 (ole2.h)

  • 發行項

建立連結至檔案的物件。

語法

HRESULT OleCreateLinkToFile(
  [in]  LPCOLESTR       lpszFileName,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

參數

[in] lpszFileName

字串的指標，將來源檔案命名為要連結的來源檔案。

[in] riid

呼叫端稍後用來與新物件通訊之介面的參考 (通常是IID_IOleObject，在 OLE 標頭中定義為 IOleObject) 的介面識別碼。

[in] renderopt

列舉 OLERENDER 的值，指出新建立之物件必須擁有的本機快取繪圖或資料擷取功能。 下列一節會說明其他考慮。

[in] lpFormatEtc

列舉 OLERENDER 中的值指標，指出新建立物件必須擁有的本機快取繪圖或資料擷取功能。 所選 的 OLERENDER 值會影響 pFormatEtc 參數的可能值。

[in] pClientSite

IOleClientSite實例的指標，這是物件從其容器要求服務的主要介面。 此參數可以是 Null。

[in] pStg

儲存體物件上 IStorage 介面的指標。 此參數不可為 Null。

[out] ppvObj

接收 riid 中要求的介面指標的指標變數位址。 成功傳回時，*ppvObj 會在新建立的物件上包含要求的介面指標。

傳回值

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

傳回碼 描述
STG_E_FILENOTFOUND
 檔案名稱無效。
OLE_E_CANT_BINDTOSOURCE
 無法系結至來源。

備註

OleCreateLinkToFile函式與OleCreateLink函式不同，因為它可以建立不感知 OLE 的檔案連結，以及使用 Windows Packager 的檔案連結。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ole2.h
程式庫 Ole32.lib
Dll Ole32.dll

另請參閱

OleCreateLink