Metodo IDataObject::QueryGetData (objidl.h)

Determina se l'oggetto dati è in grado di eseguire il rendering dei dati come specificato. Gli oggetti che tentano un'operazione incolla o drop possono chiamare questo metodo prima di chiamare IDataObject::GetData per ottenere un'indicazione del fatto che l'operazione possa essere riuscita.

Sintassi

HRESULT QueryGetData(
  [in] FORMATETC *pformatetc
);

Parametri

[in] pformatetc

Puntatore alla struttura FORMATETC che definisce il formato, il supporto e il dispositivo di destinazione da usare per la query.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Altri valori possibili includono quanto segue

Codice restituito	Descrizione
DV_E_LINDEX	Valore non valido per lindex; attualmente è supportato solo -1.
DV_E_FORMATETC	Valore non valido per pformatetc.
DV_E_TYMED	Il valore tymed non è valido.
DV_E_DVASPECT	Il valore dwAspect non è valido.
OLE_E_NOTRUNNING	L'applicazione dell'oggetto non è in esecuzione.
E_UNEXPECTED	Si è verificato un errore imprevisto.
E_INVALIDARG	Il valore dwDirection non è valido.
E_OUTOFMEMORY	Per questa operazione è disponibile memoria insufficiente.

Commenti

Il client di un oggetto dati chiama QueryGetData per determinare se passare la struttura FORMATETC specificata a una chiamata successiva a IDataObject::GetData è probabile che venga eseguita correttamente. Una restituzione riuscita da questo metodo non garantisce necessariamente l'esito positivo dell'operazione di incolla o eliminazione successiva.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	objidl.h

Vedi anche

Idataobject