Partager via

OleQueryCreateFromData, fonction (ole2.h)

  • Article

Vérifie si un objet de données a l’un des formats qui lui permettrait de devenir un objet incorporé via un appel à la fonction OleCreateFromData ou OleCreateStaticFromData .

Syntaxe

HRESULT OleQueryCreateFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

Paramètres

[in] pSrcDataObject

Pointeur vers l’interface IDataObject sur l’objet de transfert de données à interroger.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Code de retour Description
S_FALSE
 Aucun format ne prend en charge la création d’objets incorporés ou statiques.
OLE_S_STATIC
 Les formats qui prennent en charge la création d’objets statiques sont présents.

Remarques

Lorsqu’une application récupère un objet de transfert de données via un appel à la fonction OleGetClipboard , l’application doit appeler OleQueryCreateFromData dans le cadre du processus d’activation ou de désactivation des commandes Edit/Paste ou Edit/Paste Special... . Il teste la présence des formats suivants dans l’objet de données :

  • CF_EMBEDDEDOBJECT
  • CF_EMBEDSOURCE
  • cfFileName
  • CF_METAFILEPICT
  • CF_DIB
  • CF_BITMAP
  • CF_ENHMETAFILE
Déterminer que l’objet de données a l’un de ces formats ne garantit pas absolument que la création de l’objet réussira, mais est destiné à aider le processus.

Si OleQueryCreateFromData trouve l’un des formats CF_METAFILEPICT, CF_BITMAP, CF_DIB ou CF_ENHMETAFILE et aucun des autres formats, il retourne OLE_S_STATIC, indiquant que vous devez appeler la fonction OleCreateStaticFromData pour créer l’objet incorporé.

Si OleQueryCreateFromData trouve l’un des autres formats (CF_EMBEDDEDOBJECT, CF_EMBEDSOURCE ou cfFileName), même en combinaison avec les formats statiques, il retourne S_OK, indiquant que vous devez appeler la fonction OleCreateFromData pour créer l’objet incorporé.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête ole2.h
Bibliothèque Ole32.lib
DLL Ole32.dll
Ensemble d’API ext-ms-win-com-ole32-l1-1-3 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

OleCreateFromData

OleCreateStaticFromData

OleQueryLinkFromData