OleCreateFromData 函式 (ole2.h)
從剪貼簿擷取的數據傳輸物件，或作為 OLE 拖放作業的一部分，建立內嵌物件。 它是用來從 OLE 拖放作業實作貼上。
語法
HRESULT OleCreateFromData(
[in] LPDATAOBJECT pSrcDataObj,
[in] REFIID riid,
[in] DWORD renderopt,
[in] LPFORMATETC pFormatEtc,
[in] LPOLECLIENTSITE pClientSite,
[in] LPSTORAGE pStg,
[out] LPVOID *ppvObj
);
參數
[in] pSrcDataObj
數據傳送物件上 IDataObject 介面的指標，該物件會保存建立對象的數據。
[in] riid
呼叫端稍後用來與新對象通訊之介面標識碼的參考 (通常IID_IOleObject，在 OLE 標頭中定義為 IOleObject) 的介面識別符。
[in] renderopt
列舉 OLERENDER 的值，指出新建立物件所要擁有的本機快取繪圖或數據擷取功能。 下列一節將說明其他考慮。
[in] pFormatEtc
列舉 OLERENDER 中的值指標，指出新建立物件所要擁有的本機快取繪圖或數據擷取功能。 所選 的 OLERENDER 值會影響 pFormatEtc 參數的可能值。
[in] pClientSite
IOleClientSite 實例的指標，這是物件從其容器要求服務的主要介面。 此參數可以是 Null。
[in] pStg
記憶體物件上 IStorage 介面的指標。 此參數可能不是 NULL。
[out] ppvObj
接收 riid 中所要求介面指標的指標變數位址。 成功傳回時，*ppvObj 會在新建立的物件上包含要求的介面指標。
傳回值
此函式會在成功時傳回S_OK。 其他可能的值包括下列專案。
| 傳回碼 | Description |
|---|---|
|
表示 OLE 只能建立靜態物件。 |
|
物件建立沒有可接受的格式。 |
備註
OleCreateFromData 函式會從支援 IDataObject 介面的數據傳輸物件建立內嵌物件。 在此情況下，數據物件是使用 OleGetClipboard 函式呼叫從剪貼簿擷取的類型，或是 OLE 拖放作業的一部分， (數據對象會傳遞至 呼叫 IDropTarget：:D rop) 。
如果數據傳輸物件中有 FileName 或 FileNameW 剪貼簿格式 (CF_FILENAME) ，而且CF_EMBEDDEDOBJECT或CF_EMBEDSOURCE不存在， OleCreateFromData 會先嘗試建立包含指定檔案的封裝。 一般而言，它會採用第一個可用的格式。
如果 OleCreateFromData 無法建立封裝，它會嘗試使用 CF_EMBEDDEDOBJECT 格式來建立物件。 如果該格式無法使用， OleCreateFromData 會嘗試使用 CF_EMBEDSOURCE 格式建立它。 如果這兩種格式都無法使用，而且數據傳輸物件都不支援 IPersistStorage 介面， OleCreateFromData 會呼叫物件的 IPersistStorage：：Save ，讓物件自行儲存。
如果選取現有的連結物件，則複製後，它會在剪貼簿上顯示為另一個可內嵌的物件。 因此，叫用 OleCreateFromData 的貼上作業可能會建立連結的物件。 貼上作業之後，容器應該呼叫 QueryInterface 函式，要求 OLE 標頭中定義的IID_IOleLink (做为 IOleLink) 的介面標識碼，以判斷是否已建立連結的物件。
使用 renderopt 和 pFormatetc 參數來控制新建立物件的快取功能。 如需使用這些參數互動來判斷要快取之專案的一般資訊，請參閱 OLERENDER 列舉。 不過，在 OleCreateFromData 初始化快取的方式上，這些參數會有一些額外的特定效果。
當 OleCreateFromData 使用CF_EMBEDDEDOBJECT或CF_EMBEDSOURCE剪貼簿格式來建立內嵌物件時，兩者之間的主要差異在於快取初始化數據的儲存位置：
- CF_EMBEDDEDOBJECT表示來源是現有的內嵌物件。 其快取中已經有適當的數據，OLE 會使用此數據來初始化新物件的快取。
- CF_EMBEDSOURCE表示源數據物件包含CF_EMBEDSOURCE以外的格式的快取初始化資訊。 OleCreateFromData 會使用這些屬性來初始化新內嵌物件的快取。
| 值 | Description |
|---|---|
| OLERENDER_DRAW & OLERENDER_FORMAT | 如果要快取的簡報資訊目前存在於適當的快取初始化集區中，則會使用它。 (適當的位置位於源數據物件快取中，用於CF_EMBEDDEDOBJECT，而源數據物件中的其他格式則為 CF_EMBEDSOURCE.) 如果資訊不存在，則快取一開始是空的，但會在第一次執行物件時填入。 新建立的物件中不會快取其他格式。 |
| OLERENDER_NONE | 新建立的物件中不會快取任何內容。 如果來源具有CF_EMBEDDEDOBJECT格式，則會移除任何已複製的現有快取數據。 |
| OLERENDER_ASIS | 如果來源具有CF_EMBEDDEDOBJECT格式，新物件的快取就是包含與來源物件相同的快取數據。 對於CF_EMBEDSOURCE，新建立的物件中不會快取任何內容。 這個選項應該由更複雜的容器使用。 在此呼叫之後，這類容器會呼叫 IOleCache：：Cache 和 IOleCache：：Uncache ，以確切設定要快取的內容。 針對CF_EMBEDSOURCE，他們接著也會呼叫 IOleCache：：InitCache。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | ole2.h |
| 程式庫 | Ole32.lib |
| Dll | Ole32.dll |
| API 集合 | ext-ms-win-com-ole32-l1-1-3 (Windows 10 10.0.10240 版) |