GetEnhMetaFileHeader, fonction (wingdi.h)
La fonction GetEnhMetaFileHeader récupère l’enregistrement contenant l’en-tête du métafichier au format amélioré spécifié.
Syntaxe
UINT GetEnhMetaFileHeader(
[in] HENHMETAFILE hemf,
[in] UINT nSize,
[out] LPENHMETAHEADER lpEnhMetaHeader
);
Paramètres
[in] hemf
Handle du métafichier amélioré pour lequel l’en-tête doit être récupéré.
[in] nSize
Taille, en octets, de la mémoire tampon à recevoir les données. Seuls ces octets seront copiés.
[out] lpEnhMetaHeader
Pointeur vers une structure ENHMETAHEADER qui reçoit l’enregistrement d’en-tête. Si ce paramètre a la valeur NULL, la fonction retourne la taille de l’enregistrement d’en-tête.
Valeur retournée
Si la fonction réussit et que le pointeur de structure a la valeur NULL, la valeur renvoyée correspond à la taille de l’enregistrement qui contient l’en-tête ; si le pointeur de structure est un pointeur valide, la valeur renvoyée est le nombre d’octets copiés. Sinon, c’est zéro.
Remarques
Un en-tête enhanced-metafile contient des informations telles que la taille du métafichier, en octets ; dimensions de l’image stockée dans le métafichier ; le nombre d’enregistrements stockés dans le métafichier ; décalage par rapport à la description de texte facultative ; la taille de la palette facultative et la résolution de l’appareil sur lequel l’image a été créée.
L’enregistrement qui contient l’en-tête enhanced-metafile est toujours le premier enregistrement du métafichier.
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 |