IDataObject：：QueryGetData 方法 (objidl.h)

  • 發行項

判斷數據物件是否能夠依指定轉譯數據。 嘗試貼上或卸除作業的物件可以在呼叫 IDataObject：：GetData 之前呼叫此方法，以取得作業是否可能成功的指示。

語法

HRESULT QueryGetData(
  [in] FORMATETC *pformatetc
);

參數

[in] pformatetc

FORMATETC 結構的指標，定義要用於查詢的格式、中型和目標裝置。

傳回值

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

傳回碼 Description
DV_E_LINDEX
 lindex 的值無效;目前僅支援 -1。
DV_E_FORMATETC
 pformatetc 的值無效。
DV_E_TYMED
 tymed 值無效。
DV_E_DVASPECT
 dwAspect 值無效。
OLE_E_NOTRUNNING
 物件應用程式未執行。
E_UNEXPECTED
 已發生未預期的錯誤。
E_INVALIDARG
 dwDirection 值無效。
E_OUTOFMEMORY
 此作業的記憶體不足。

備註

數據物件的用戶端會呼叫 QueryGetData ，以判斷是否要將指定的 FORMATETC 結構傳遞至 IDataObject：：GetData 的後續呼叫是否可能成功。 從這個方法成功傳回，不一定會確保後續貼上或卸除作業成功。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 objidl.h

另請參閱

IDataObject