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

  • Artigo

Determina se o objeto de dados é capaz de renderizar os dados conforme especificado. Objetos que tentam uma operação de colar ou soltar podem chamar esse método antes de chamar IDataObject::GetData para obter uma indicação de se a operação pode ser bem-sucedida.

Sintaxe

HRESULT QueryGetData(
  [in] FORMATETC *pformatetc
);

Parâmetros

[in] pformatetc

Um ponteiro para a estrutura FORMATETC que define o formato, o dispositivo médio e de destino a ser usado para a consulta.

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores possíveis incluem os seguintes

Código de retorno Descrição
DV_E_LINDEX
 Valor inválido para lindex; atualmente, há suporte apenas para -1.
DV_E_FORMATETC
 Valor inválido para pformatetc.
DV_E_TYMED
 O valor de tymed não é válido.
DV_E_DVASPECT
 O valor dwAspect não é válido.
OLE_E_NOTRUNNING
 O aplicativo de objeto não está em execução.
E_UNEXPECTED
 Ocorreu um erro inesperado.
E_INVALIDARG
 O valor dwDirection não é válido.
E_OUTOFMEMORY
 Não há memória suficiente disponível para esta operação.

Comentários

O cliente de um objeto de dados chama QueryGetData para determinar se a passagem da estrutura FORMATETC especificada para uma chamada subsequente para IDataObject::GetData provavelmente será bem-sucedida. Um retorno bem-sucedido desse método não garante necessariamente o sucesso da operação subsequente de colagem ou remoção.

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 objidl.h

Confira também

Idataobject