CopyEnhMetaFileA, fonction (wingdi.h)

La fonction CopyEnhMetaFile copie le contenu d’un métafichier au format amélioré dans un fichier spécifié.

Syntaxe

HENHMETAFILE CopyEnhMetaFileA(
  [in] HENHMETAFILE hEnh,
  [in] LPCSTR       lpFileName
);

Paramètres

[in] hEnh

Handle du métafichier amélioré à copier.

[in] lpFileName

Pointeur vers le nom du fichier de destination. Si ce paramètre a la valeur NULL, le métafichier source est copié en mémoire.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour la copie du métafichier amélioré.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

Lorsque les arguments de texte doivent utiliser des caractères Unicode, utilisez la fonction CopyEnhMetaFile comme fonction à caractères larges. Lorsque les arguments de texte doivent utiliser des caractères du jeu de caractères Windows, utilisez cette fonction comme fonction ANSI.

Les applications peuvent utiliser des métafichiers stockés en mémoire pour des opérations temporaires.

Lorsque l’application n’a plus besoin du handle enhanced-metafile, elle doit supprimer le handle en appelant la fonction DeleteEnhMetaFile .

Notes

L’en-tête wingdi.h définit CopyEnhMetaFile en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Voir aussi

DeleteEnhMetaFile

Fonctions de métafichier

Vue d’ensemble des métafichiers