共用方式為

OleQueryCreateFromData 函式 (ole2.h)

  • 發行項

檢查數據物件是否有一種格式，可讓它透過 呼叫 OleCreateFromData 或 OleCreateStaticFromData 函式成為內嵌物件。

語法

HRESULT OleQueryCreateFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

參數

[in] pSrcDataObject

要查詢之數據傳輸物件上 IDataObject 介面的指標。

傳回值

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

傳回碼 Description
S_FALSE
 沒有支援內嵌或靜態物件建立的格式。
OLE_S_STATIC
 支援靜態物件建立的格式存在。

備註

當應用程式透過呼叫 OleGetClipboard 函式擷取數據傳輸物件時，應用程式應該在決定啟用或停用 Edit/Paste 或 Edit/Paste Special... 命令的過程中呼叫 OleQueryCreateFromData。 它會測試資料物件中是否有下列格式：

  • CF_EMBEDDEDOBJECT
  • CF_EMBEDSOURCE
  • cfFileName
  • CF_METAFILEPICT
  • CF_DIB
  • CF_BITMAP
  • CF_ENHMETAFILE
判斷數據物件有下列其中一種格式，並不絕對保證物件建立會成功，但旨在協助程式。

如果 OleQueryCreateFromData 找到其中一個CF_METAFILEPICT、CF_BITMAP、CF_DIB或CF_ENHMETAFILE格式，而且沒有任何其他格式，則會傳回OLE_S_STATIC，指出您應該呼叫 OleCreateStaticFromData 函式來建立內嵌物件。

如果 OleQueryCreateFromData 找到其他其中一種格式 (CF_EMBEDDEDOBJECT、CF_EMBEDSOURCE或 cfFileName) ，即使與靜態格式結合，也會傳回S_OK，指出您應該呼叫 OleCreateFromData 函式來建立內嵌物件。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 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 版)

另請參閱

OleCreateFromData

OleCreateStaticFromData

OleQueryLinkFromData