Fonction GetEnhMetaFileBits (wingdi.h)
La fonction GetEnhMetaFileBits récupère le contenu du métafichier au format amélioré spécifié et les copie dans une mémoire tampon.
Syntaxe
UINT GetEnhMetaFileBits(
[in] HENHMETAFILE hEMF,
[in] UINT nSize,
[out] LPBYTE lpData
);
Paramètres
[in] hEMF
Handle du métafichier amélioré.
[in] nSize
Taille, en octets, de la mémoire tampon à recevoir les données.
[out] lpData
Pointeur vers une mémoire tampon qui reçoit les données du métafichier. La mémoire tampon doit être suffisamment grande pour contenir les données. Si lpbBuffer a la valeur NULL, la fonction retourne la taille nécessaire pour contenir les données.
Valeur retournée
Si la fonction réussit et que le pointeur de mémoire tampon a la valeur NULL, la valeur de retour correspond à la taille du métafichier amélioré, en octets.
Si la fonction réussit et que le pointeur de la mémoire tampon est un pointeur valide, la valeur de retour correspond au nombre d’octets copiés dans la mémoire tampon.
Si la fonction échoue, la valeur de retour est égale à zéro.
Remarques
Une fois les bits de métafichiers améliorés récupérés, ils peuvent être utilisés pour créer un métafichier basé sur la mémoire en appelant la fonction SetEnhMetaFileBits .
La fonction GetEnhMetaFileBits n’invalide pas le handle enhanced-metafile. L’application doit appeler la fonction DeleteEnhMetaFile pour supprimer le handle quand il n’est plus nécessaire.
Le contenu du métafichier récupéré par cette fonction est au format amélioré. Pour récupérer le contenu du métafichier au format Windows, utilisez la fonction GetWinMetaFileBits .
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 |