OleQueryCreateFromData-Funktion (ole2.h)

  • Artikel

Überprüft, ob ein Datenobjekt über eines der Formate verfügt, die es durch einen Aufruf der OleCreateFromData - oder OleCreateStaticFromData-Funktion zu einem eingebetteten Objekt werden lassen.

Syntax

HRESULT OleQueryCreateFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

Parameter

[in] pSrcDataObject

Zeiger auf die IDataObject-Schnittstelle des abzufragenden Datenübertragungsobjekts.

Rückgabewert

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

Rückgabecode Beschreibung
S_FALSE
 Es sind keine Formate vorhanden, die die Erstellung eingebetteter oder statischer Objekte unterstützen.
OLE_S_STATIC
 Formate, die die Erstellung statischer Objekte unterstützen, sind vorhanden.

Hinweise

Wenn eine Anwendung ein Datenübertragungsobjekt über einen Aufruf der OleGetClipboard-Funktion abruft, sollte die Anwendung OleQueryCreateFromData aufrufen, um die Befehle Edit/Paste oder Edit/Paste Special... zu aktivieren oder zu deaktivieren. Es wird getestet, ob die folgenden Formate im Datenobjekt vorhanden sind:

  • CF_EMBEDDEDOBJECT
  • CF_EMBEDSOURCE
  • cfFileName
  • CF_METAFILEPICT
  • CF_DIB
  • CF_BITMAP
  • CF_ENHMETAFILE
Die Feststellung, dass das Datenobjekt über eines dieser Formate verfügt, garantiert nicht unbedingt, dass die Objekterstellung erfolgreich ist, sondern soll den Prozess unterstützen.

Wenn OleQueryCreateFromData eines der CF_METAFILEPICT-, CF_BITMAP-, CF_DIB- oder CF_ENHMETAFILE-Formate und keines der anderen Formate findet, gibt es OLE_S_STATIC zurück, was angibt, dass Sie die OleCreateStaticFromData-Funktion aufrufen sollten, um das eingebettete Objekt zu erstellen.

Wenn OleQueryCreateFromData eines der anderen Formate (CF_EMBEDDEDOBJECT, CF_EMBEDSOURCE oder cfFileName) findet, gibt es auch in Kombination mit den statischen Formaten S_OK zurück, was angibt, dass Sie die OleCreateFromData-Funktion aufrufen sollten, um das eingebettete Objekt zu erstellen.

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 ole2.h
Bibliothek Ole32.lib
DLL Ole32.dll
APIs ext-ms-win-com-ole32-l1-1-3 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

OleCreateFromData

OleCreateStaticFromData

OleQueryLinkFromData