Función GetEnhMetaFileBits (wingdi.h)

  • Artículo

La función GetEnhMetaFileBits recupera el contenido del metarchivo de formato mejorado especificado y los copia en un búfer.

Sintaxis

UINT GetEnhMetaFileBits(
  [in]  HENHMETAFILE hEMF,
  [in]  UINT         nSize,
  [out] LPBYTE       lpData
);

Parámetros

[in] hEMF

Identificador del metarchivo mejorado.

[in] nSize

Tamaño, en bytes, del búfer para recibir los datos.

[out] lpData

Puntero a un búfer que recibe los datos del metarchivo. El búfer debe ser lo suficientemente grande para contener los datos. Si lpbBuffer es NULL, la función devuelve el tamaño necesario para contener los datos.

Valor devuelto

Si la función se ejecuta correctamente y el puntero del búfer es NULL, el valor devuelto es el tamaño del metarchivo mejorado, en bytes.

Si la función se ejecuta correctamente y el puntero del búfer es un puntero válido, el valor devuelto es el número de bytes copiados en el búfer.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Una vez recuperados los bits de metarchivo mejorado, se pueden usar para crear un metarchivo basado en memoria llamando a la función SetEnhMetaFileBits .

La función GetEnhMetaFileBits no invalida el identificador de metarchivo mejorado. La aplicación debe llamar a la función DeleteEnhMetaFile para eliminar el identificador cuando ya no sea necesario.

El contenido del metarchivo recuperado por esta función tiene el formato mejorado. Para recuperar el contenido del metarchivo en formato Windows, use la función GetWinMetaFileBits .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

DeleteEnhMetaFile

GetWinMetaFileBits

Funciones de metarchivo

Introducción a los metarchivos

SetEnhMetaFileBits