COleDataObject::GetFileData

Article
03/04/2013

Appelez cette fonction pour créer CFile ou CFileobjet dérivé et extraire des données dans le format spécifié dans un pointeur d' CFile .

CFile* GetFileData(
   CLIPFORMAT cfFormat,
   LPFORMATETC lpFormatEtc = NULL 
);

Paramètres

cfFormat
Le format dans lequel les données doivent être retournées.Ce paramètre peut être un des formats de presse-papiers prédéfinis ou de la valeur retourné par la fonction native de RegisterClipboardFormat windows.
lpFormatEtc
Les points à structure FORMATETC décrire le format dans lequel les données doivent être retournées.Indiquez une valeur pour ce paramètre si vous souhaitez spécifier des informations de mise en forme supplémentaires au delà de le format de presse-papiers spécifié par cfFormat.Si c'est NULL, les valeurs par défaut sont utilisées pour les autres champs dans la structure de FORMATETC .

Valeur de retour

Pointeur vers nouvel CFile ou à CFileobjet dérivé contenant les données si l'opération a réussi ; sinon NULL.

Notes

Selon la prise en charge que les données sont stockées dans, le type réel globale pointe vers la valeur de retour peuvent être CFile, CSharedFile, ou COleStreamFile.

[!REMARQUE]

L'objet d' CFile accessible par la valeur de retour de cette fonction est détenu par l'appelant.Il est de la responsabilité de l'appelant à supprimer l'objet d' CFile , la fermeture de ce fait le fichier.

Pour plus d'informations, consultez FORMATETC dans Kit de développement logiciel Windows.

Pour plus d'informations, consultez RegisterClipboardFormat dans Kit de développement logiciel Windows.