OleCreateLink 函式 (ole2.h)

建立 OLE 複合檔案連結化物件。

語法

HRESULT OleCreateLink(
  [in]  LPMONIKER       pmkLinkSrc,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

參數

[in] pmkLinkSrc

Moniker 上 IMoniker介面的指標，可用來尋找連結化物件的來源。

[in] riid

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

[in] renderopt

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

[in] lpFormatEtc

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

[in] pClientSite

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

[in] pStg

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

[out] ppvObj

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

傳回值

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

傳回碼	描述
OLE_E_CANT_BINDTOSOURCE	無法系結至來源。

備註

呼叫 OleCreateLink 以允許容器建立物件的連結。

需求

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

另請參閱

IOleClientSite：：GetMoniker

IOleObject：：SetMoniker