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 |
|---|---|
|
Ungültiger Wert für lindex; derzeit wird nur -1 unterstützt. |
|
Ungültiger Wert für pformatetc. |
|
Der tymed-Wert ist ungültig. |
|
Der dwAspect-Wert ist ungültig. |
|
Die Objektanwendung wird nicht ausgeführt. |
|
Ein unerwarteter Fehler ist aufgetreten. |
|
Der dwDirection-Wert ist ungültig. |
|
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 |