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.
See Also