Méthode IDataObject ::QueryGetData (objidl.h)

  • Article

Détermine si l'objet de données est capable de rendre les données comme spécifié. Les objets tentant une opération de collage ou de suppression peuvent appeler cette méthode avant d’appeler IDataObject ::GetData pour obtenir une indication de la réussite de l’opération.

Syntaxe

HRESULT QueryGetData(
  [in] FORMATETC *pformatetc
);

Paramètres

[in] pformatetc

Pointeur vers la structure FORMATETC définissant le format, le moyen et l’appareil cible à utiliser pour la requête.

Valeur retournée

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

Code de retour Description
DV_E_LINDEX
 Valeur non valide pour lindex ; Actuellement, seul -1 est pris en charge.
DV_E_FORMATETC
 Valeur non valide pour pformatetc.
DV_E_TYMED
 La valeur tyd n’est pas valide.
DV_E_DVASPECT
 La valeur dwAspect n’est pas valide.
OLE_E_NOTRUNNING
 L’application objet n’est pas en cours d’exécution.
E_UNEXPECTED
 Une erreur inattendue s’est produite.
E_INVALIDARG
 La valeur dwDirection n’est pas valide.
E_OUTOFMEMORY
 La mémoire disponible pour cette opération est insuffisante.

Remarques

Le client d’un objet de données appelle QueryGetData pour déterminer si le passage de la structure FORMATETC spécifiée à un appel ultérieur à IDataObject ::GetData est susceptible de réussir. Un retour réussi de cette méthode ne garantit pas nécessairement la réussite de l’opération de collage ou de suppression suivante.

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 objidl.h

Voir aussi

Idataobject