CopyMetaFileA, fonction (wingdi.h)
La fonction CopyMetaFile copie le contenu d’un métafichier au format Windows dans le fichier spécifié.
Syntaxe
HMETAFILE CopyMetaFileA(
[in] HMETAFILE unnamedParam1,
[in] LPCSTR unnamedParam2
);
Paramètres
[in] unnamedParam1
Handle pour le métafichier au format Windows source.
[in] unnamedParam2
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 au format Windows.
Si la fonction échoue, la valeur de retour est NULL.
Remarques
Lorsque les arguments de texte doivent utiliser des caractères Unicode, utilisez cette fonction 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.
Lorsque l’application n’a plus besoin du handle de métafichier au format Windows, elle doit supprimer le handle en appelant la fonction DeleteMetaFile .
Notes
L’en-tête wingdi.h définit CopyMetaFile 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
| 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 | wingdi.h (inclure Windows.h) |
| Bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |