Función OleQueryCreateFromData (ole2.h)

  • Artículo

Comprueba si un objeto de datos tiene uno de los formatos que le permitirían convertirse en un objeto incrustado a través de una llamada a la función OleCreateFromData o OleCreateStaticFromData .

Sintaxis

HRESULT OleQueryCreateFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

Parámetros

[in] pSrcDataObject

Puntero a la interfaz IDataObject del objeto de transferencia de datos que se va a consultar.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles son los siguientes.

Código devuelto Descripción
S_FALSE
 No hay ningún formato que admita la creación de objetos incrustados o estáticos.
OLE_S_STATIC
 Los formatos que admiten la creación de objetos estáticos están presentes.

Comentarios

Cuando una aplicación recupera un objeto de transferencia de datos a través de una llamada a la función OleGetClipboard , la aplicación debe llamar a OleQueryCreateFromData como parte del proceso de decidir habilitar o deshabilitar los comandos Edit/Paste o Edit/Paste Special... . Comprueba la presencia de los siguientes formatos en el objeto de datos:

  • CF_EMBEDDEDOBJECT
  • CF_EMBEDSOURCE
  • cfFileName
  • CF_METAFILEPICT
  • CF_DIB
  • CF_BITMAP
  • CF_ENHMETAFILE
Determinar que el objeto de datos tiene uno de estos formatos no garantiza absolutamente que la creación del objeto se realice correctamente, pero está pensada para ayudar al proceso.

Si OleQueryCreateFromData encuentra uno de los formatos CF_METAFILEPICT, CF_BITMAP, CF_DIB o CF_ENHMETAFILE y ninguno de los otros formatos, devuelve OLE_S_STATIC, lo que indica que debe llamar a la función OleCreateStaticFromData para crear el objeto incrustado.

Si OleQueryCreateFromData encuentra uno de los otros formatos (CF_EMBEDDEDOBJECT, CF_EMBEDSOURCE o cfFileName), incluso en combinación con los formatos estáticos, devuelve S_OK, lo que indica que debe llamar a la función OleCreateFromData para crear el objeto incrustado.

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 ole2.h
Library Ole32.lib
Archivo DLL Ole32.dll
Conjunto de API ext-ms-win-com-ole32-l1-1-3 (introducido en Windows 10, versión 10.0.10240)

Consulte también

OleCreateFromData

OleCreateStaticFromData

OleQueryLinkFromData