Función EnumMetaFile (wingdi.h)

Artículo
03/08/2023

La función EnumMetaFile enumera los registros dentro de un metarchivo de formato Windows recuperando cada registro y pasándolo a la función de devolución de llamada especificada. La función de devolución de llamada proporcionada por la aplicación procesa cada registro según sea necesario. La enumeración continúa hasta que se procesa el último registro o cuando la función de devolución de llamada devuelve cero.

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 EnumEnhMetaFile.

Sintaxis

BOOL EnumMetaFile(
  [in] HDC        hdc,
  [in] HMETAFILE  hmf,
  [in] MFENUMPROC proc,
  [in] LPARAM     param
);

Parámetros

[in] hdc

Identificador de un contexto de dispositivo. Este identificador se pasa a la función de devolución de llamada.

[in] hmf

Identificador de un metarchivo de formato Windows.

[in] proc

Puntero a una función de devolución de llamada proporcionada por la aplicación. Para obtener más información, vea EnumMetaFileProc.

[in] param

Puntero a datos opcionales.

Valor devuelto

Si la función de devolución de llamada enumera correctamente todos los registros del metarchivo de formato Windows, el valor devuelto es distinto de cero.

Si la función de devolución de llamada no enumera correctamente todos los registros del metarchivo de formato Windows, el valor devuelto es cero.

Comentarios

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

Puede usar la función EnumMetaFile para insertar un metarchivo de formato Windows dentro de otro.

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