IDataObject::QueryGetData

Determines whether the data object is capable of rendering the data described in the FORMATETC structure. Objects attempting a paste or drop operation can call this method before calling IDataObject::GetData to get an indication of whether the operation may be successful.

HRESULT QueryGetData(
  FORMATETC * pFormatetc  //Pointer to the FORMATETC structure
);

Parameter

pFormatetc: [in] Pointer to the FORMATETC structure defining the format, medium, and target device to use for the query.

Return Values

This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following:

S_OK: Subsequent call to IDataObject::GetData would probably be successful.
DV_E_LINDEX: Invalid value for lindex; currently, only -1 is supported.
DV_E_FORMATETC: Invalid value for pFormatetc.
DV_E_TYMED: Invalid tymed value.
DV_E_DVASPECT: Invalid dwAspect value.
OLE_E_NOTRUNNING: Object application is not running.

Remarks

The client of a data object calls IDataObject::QueryGetData to determine whether passing the specified FORMATETC structure to a subsequent call to IDataObject::GetData is likely to be successful. A successful return from this method does not necessarily ensure the success of the subsequent paste or drop operation.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in objidl.h.