IDataObject::QueryGetData-Methode (objidl.h)

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