Función SetMetaFileBitsEx (wingdi.h)

Artículo
08/27/2023

La función SetMetaFileBitsEx crea un metarchivo de formato Windows basado en memoria a partir de los datos proporcionados.

Nota Esta función solo se proporciona para la compatibilidad con los 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 SetEnhMetaFileBits.

Sintaxis

HMETAFILE SetMetaFileBitsEx(
  [in] UINT       cbBuffer,
  [in] const BYTE *lpData
);

Parámetros

[in] cbBuffer

Especifica el tamaño, en bytes, del metarchivo de formato Windows.

[in] lpData

Puntero a un búfer que contiene el metarchivo de formato Windows. (Se supone que los datos se obtuvieron mediante la función GetMetaFileBitsEx ).

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de un metarchivo de formato Windows basado en memoria.

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

Comentarios

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

Cuando la aplicación ya no necesita el identificador de metarchivo devuelto por SetMetaFileBitsEx, debe eliminarlo llamando a la función DeleteMetaFile .

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