Método IDataObject::QueryGetData (objidl.h)

  • Artículo

Determina si el objeto de datos es capaz de representar los datos según lo especificado. Los objetos que intentan realizar una operación de pegado o colocar pueden llamar a este método antes de llamar a IDataObject::GetData para obtener una indicación de si la operación puede ser correcta.

Sintaxis

HRESULT QueryGetData(
  [in] FORMATETC *pformatetc
);

Parámetros

[in] pformatetc

Puntero a la estructura FORMATETC que define el formato, el medio y el dispositivo de destino que se usará para la consulta.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros valores posibles son los siguientes:

Código devuelto Descripción
DV_E_LINDEX
 Valor no válido para lindex; actualmente, solo se admite -1.
DV_E_FORMATETC
 Valor no válido para pformatetc.
DV_E_TYMED
 El valor tymed no es válido.
DV_E_DVASPECT
 El valor dwAspect no es válido.
OLE_E_NOTRUNNING
 La aplicación de objeto no se está ejecutando.
E_UNEXPECTED
 Se produjo un error inesperado.
E_INVALIDARG
 El valor dwDirection no es válido.
E_OUTOFMEMORY
 No hay suficiente memoria disponible para esta operación.

Comentarios

El cliente de un objeto de datos llama a QueryGetData para determinar si es probable que se pase la estructura FORMATETC especificada a una llamada posterior a IDataObject::GetData . Una devolución correcta de este método no garantiza necesariamente el éxito de la operación posterior de pegado o eliminación.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado objidl.h

Consulte también

IDataObject