IDataObject::QueryGetData-Methode (objidl.h)

  • Artikel

Bestimmt, ob das Datenobjekt die Daten wie beschrieben rendern kann. Objekte, die einen Einfüge- oder Löschvorgang versuchen, können diese Methode aufrufen, bevor sie IDataObject::GetData aufrufen, um einen Hinweis darauf zu erhalten, ob der Vorgang erfolgreich ist.

Syntax

HRESULT QueryGetData(
  [in] FORMATETC *pformatetc
);

Parameter

[in] pformatetc

Ein Zeiger auf die FORMATETC-Struktur , die das Format, das Medium und das Zielgerät definiert, das für die Abfrage verwendet werden soll.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode Beschreibung
DV_E_LINDEX
 Ungültiger Wert für lindex; derzeit wird nur -1 unterstützt.
DV_E_FORMATETC
 Ungültiger Wert für pformatetc.
DV_E_TYMED
 Der tymed-Wert ist ungültig.
DV_E_DVASPECT
 Der dwAspect-Wert ist ungültig.
OLE_E_NOTRUNNING
 Die Objektanwendung wird nicht ausgeführt.
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten.
E_INVALIDARG
 Der dwDirection-Wert ist ungültig.
E_OUTOFMEMORY
 Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Der Client eines Datenobjekts ruft QueryGetData auf, um zu bestimmen, ob die Übergabe der angegebenen FORMATETC-Struktur an einen nachfolgenden Aufruf von IDataObject::GetData wahrscheinlich erfolgreich ist. Eine erfolgreiche Rückgabe dieser Methode stellt nicht unbedingt den Erfolg des nachfolgenden Einfüge- oder Ablagevorgangs sicher.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objidl.h

Weitere Informationen

Idataobject