The EnumMetaFileProc function is an application-defined callback function that processes Windows-format metafile records. This function is called by the EnumMetaFile function.
This function is provided for compatibility with earlier versions of Microsoft Windows. Win32-based applications should use the EnhMetaFileProc and EnumEnhMetaFile functions.
int CALLBACK EnumMetaFileProc(
| HDC hDC, | // handle to device context |
| HANDLETABLE FAR *lpHTable, | // pointer to metafile handle table |
| METARECORD FAR *lpMFR, | // pointer to metafile record |
| int nObj, | // count of objects |
| LPARAM lpClientData | // pointer to optional data |
| ); |
Parameters
hDC
Identifies the device context passed to EnumMetaFile.
lpHTable
Points to a table of handles associated with the graphics objects (pens, brushes, and so on) in the metafile.
lpMFR
Points to one of the records in the metafile. This record should not be modified. (If modification is necessary, it should be performed on a copy of the record.)
nObj
Specifies the number of objects with associated handles in the handle table.
lpClientData
Points to any application-supplied data.
Return Values
This function must return a nonzero value to continue enumeration; to stop enumeration, it must return zero.
Remarks
An application must register the callback function by passing its address to the EnumMetaFile function.
EnumMetaFileProc is a placeholder for the application-supplied function name.
See Also