GetMetaFileA, fonction (wingdi.h)
[GetMetaFile n’est plus disponible pour une utilisation à partir de Windows 2000. Utilisez plutôt GetEnhMetaFile.]
La fonction GetMetaFile crée un handle qui identifie le métafichier stocké dans le fichier spécifié.
Syntaxe
HMETAFILE GetMetaFileA(
[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.
Valeur de retour
Si la fonction réussit, la valeur de retour est un handle du métafichier.
Si la fonction échoue, la valeur de retour est NULL .
Remarques
Cette fonction n’est pas implémentée dans l’API Win32. Il est fourni pour la compatibilité avec les versions 16 bits de Windows. Dans les applications Win32, utilisez la fonction GetEnhMetaFile.
Note
L’en-tête wingdi.h définit GetMetaFile comme 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | wingdi.h (include Windows.h) |
| bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |