GetEnhMetaFileA, fonction (wingdi.h)

Article
08/27/2023

La fonction GetEnhMetaFile crée un handle qui identifie le métafichier au format amélioré stocké dans le fichier spécifié.

Syntaxe

HENHMETAFILE GetEnhMetaFileA(
  [in] LPCSTR lpName
);

Paramètres

[in] lpName

Pointeur vers une chaîne terminée par null qui spécifie le nom d’un métafichier amélioré.

Valeur retournée

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

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

Remarques

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

Un métafichier au format Windows doit être converti au format amélioré avant de pouvoir être traité par la fonction GetEnhMetaFile . Pour convertir le fichier, utilisez la fonction SetWinMetaFileBits .

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.

Exemples

Pour obtenir un exemple, consultez Ouverture d’un métafichier amélioré et Affichage de son contenu.

Notes

L’en-tête wingdi.h définit GetEnhMetaFile 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