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

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