Compartilhar via

Função OleQueryCreateFromData (ole2.h)

  • Artigo

Verifica se um objeto de dados tem um dos formatos que o permitiria se tornar um objeto inserido por meio de uma chamada para a função OleCreateFromData ou OleCreateStaticFromData .

Sintaxe

HRESULT OleQueryCreateFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

Parâmetros

[in] pSrcDataObject

Ponteiro para a interface IDataObject no objeto de transferência de dados a ser consultado.

Retornar valor

Essa função retorna S_OK em caso de êxito. Outros valores possíveis incluem o seguinte.

Código de retorno Descrição
S_FALSE
 Não há formatos que dão suporte à criação de objeto estático ou inserido.
OLE_S_STATIC
 Os formatos que dão suporte à criação de objeto estático estão presentes.

Comentários

Quando um aplicativo recupera um objeto de transferência de dados por meio de uma chamada para a função OleGetClipboard , o aplicativo deve chamar OleQueryCreateFromData como parte do processo de decidir habilitar ou desabilitar os comandos Editar/Colar ou Editar/Colar Especial... . Ele testa a presença dos seguintes formatos no objeto de dados:

  • CF_EMBEDDEDOBJECT
  • CF_EMBEDSOURCE
  • cfFileName
  • CF_METAFILEPICT
  • CF_DIB
  • CF_BITMAP
  • CF_ENHMETAFILE
Determinar que o objeto de dados tem um desses formatos não garante absolutamente que a criação do objeto terá êxito, mas destina-se a ajudar no processo.

Se OleQueryCreateFromData encontrar um dos formatos CF_METAFILEPICT, CF_BITMAP, CF_DIB ou CF_ENHMETAFILE e nenhum dos outros formatos, ele retornará OLE_S_STATIC, indicando que você deve chamar a função OleCreateStaticFromData para criar o objeto inserido.

Se OleQueryCreateFromData encontrar um dos outros formatos (CF_EMBEDDEDOBJECT, CF_EMBEDSOURCE ou cfFileName), mesmo em combinação com os formatos estáticos, ele retornará S_OK, indicando que você deve chamar a função OleCreateFromData para criar o objeto inserido.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll
Conjunto de APIs ext-ms-win-com-ole32-l1-1-3 (introduzido no Windows 10, versão 10.0.10240)

Confira também

OleCreateFromData

OleCreateStaticFromData

OleQueryLinkFromData