Función GetEnhMetaFileHeader (wingdi.h)

La función GetEnhMetaFileHeader recupera el registro que contiene el encabezado del metarchivo de formato mejorado especificado.

Sintaxis

UINT GetEnhMetaFileHeader(
  [in]  HENHMETAFILE    hemf,
  [in]  UINT            nSize,
  [out] LPENHMETAHEADER lpEnhMetaHeader
);

Parámetros

[in] hemf

Identificador del metarchivo mejorado para el que se va a recuperar el encabezado.

[in] nSize

Tamaño, en bytes, del búfer para recibir los datos. Solo se copiarán estos muchos bytes.

[out] lpEnhMetaHeader

Puntero a una estructura ENHMETAHEADER que recibe el registro de encabezado. Si este parámetro es NULL, la función devuelve el tamaño del registro de encabezado.

Valor devuelto

Si la función se ejecuta correctamente y el puntero de estructura es NULL, el valor devuelto es el tamaño del registro que contiene el encabezado; si el puntero de estructura es un puntero válido, el valor devuelto es el número de bytes copiados. De lo contrario, es cero.

Comentarios

Un encabezado de metarchivo mejorado contiene información como el tamaño del metarchivo, en bytes; las dimensiones de la imagen almacenada en el metarchivo; número de registros almacenados en el metarchivo; desplazamiento a la descripción de texto opcional; el tamaño de la paleta opcional y la resolución del dispositivo en el que se creó la imagen.

El registro que contiene el encabezado de metarchivo mejorado siempre es el primer registro del metarchivo.

Requisitos

Requisito	Value
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

ENHMETAHEADER

Funciones de metarchivo

Introducción a los metarchivos

PlayEnhMetaFile