Metodo IDataObject::QueryGetData (objidl.h)

  • Articolo

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