IDataObject::QueryGetData 方法 (objidl.h)

确定数据对象是否能够按指定呈现数据。 尝试粘贴或删除操作的对象可以在调用 IDataObject::GetData 之前调用此方法,以获取操作是否可能成功的指示。

语法

HRESULT QueryGetData(
  [in] FORMATETC *pformatetc
);

参数

[in] pformatetc

指向 FORMATETC 结构的指针,用于定义要用于查询的格式、介质和目标设备。

返回值

此方法在成功时返回S_OK。 其他可能的值包括以下值

返回代码 说明
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