Función GetMetaFileBitsEx (wingdi.h)

Artículo
03/04/2024

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

Nota Esta función solo se proporciona para la compatibilidad con metarchivos de formato Windows. Los metarchivos de formato mejorado proporcionan una funcionalidad superior y se recomiendan para las nuevas aplicaciones. La función correspondiente para un metarchivo de formato mejorado es GetEnhMetaFileBits.

Sintaxis

UINT GetMetaFileBitsEx(
  [in]  HMETAFILE hMF,
  [in]  UINT      cbBuffer,
  [out] LPVOID    lpData
);

Parámetros

[in] hMF

Identificador de un metarchivo de formato Windows.

[in] cbBuffer

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 lpvData es NULL, la función devuelve el número de bytes necesarios 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 número de bytes necesarios para el búfer; 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.

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

Comentarios

Una vez recuperados los bits del metarchivo de Windows, se pueden usar para crear un metarchivo basado en memoria mediante una llamada a la función SetMetaFileBitsEx .

La función GetMetaFileBitsEx no invalida el identificador del metarchivo. Una aplicación debe eliminar este identificador llamando a la función DeleteMetaFile .

Para convertir un metarchivo de formato Windows en un metarchivo de formato mejorado, use la función SetWinMetaFileBits .

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