EnhMetaFileProc callback function

The EnhMetaFileProc function is an application-defined callback function used with the EnumEnhMetaFile function. The ENHMFENUMPROC type defines a pointer to this callback function. EnhMetaFileProc is a placeholder for the application-defined function name.

Syntax

int CALLBACK EnhMetaFileProc(
  _In_       HDC           hDC,
  _In_       HANDLETABLE   *lpHTable,
  _In_ const ENHMETARECORD *lpEMFR,
  _In_       int           nObj,
  _In_       LPARAM        lpData
);

Parameters

  • hDC [in]
    Handle to the device context passed to EnumEnhMetaFile.

  • lpHTable [in]
    Pointer to a HANDLETABLE structure representing the table of handles associated with the graphics objects (pens, brushes, and so on) in the metafile. The first entry contains the enhanced-metafile handle.

  • lpEMFR [in]
    Pointer 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 [in]
    Specifies the number of objects with associated handles in the handle table.

  • lpData [in]
    Pointer to optional data.

Return value

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

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

See also

Metafiles Overview

Metafile Functions

ENHMETARECORD

EnumEnhMetaFile

HANDLETABLE