Метод 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
Header objidl.h

См. также раздел

Idataobject