Freigeben über


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