Fonction GetEnhMetaFileBits (wingdi.h)

  • Article

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

Voir aussi

DeleteEnhMetaFile

GetWinMetaFileBits

Fonctions de métafichier

Vue d’ensemble des métafichiers

SetEnhMetaFileBits