CloseEnhMetaFile function (wingdi.h)

The CloseEnhMetaFile function closes an enhanced-metafile device context and returns a handle that identifies an enhanced-format metafile.

Syntax

HENHMETAFILE CloseEnhMetaFile(
  [in] HDC hdc
);

[in] hdc

Handle to an enhanced-metafile device context.

If the function succeeds, the return value is a handle to an enhanced metafile.

If the function fails, the return value is NULL.

An application can use the enhanced-metafile handle returned by the CloseEnhMetaFile function to perform the following tasks:

Display a picture stored in an enhanced metafile
Create copies of the enhanced metafile
Enumerate, edit, or copy individual records in the enhanced metafile
Retrieve an optional description of the metafile contents from the enhanced-metafile header
Retrieve a copy of the enhanced-metafile header
Retrieve a binary copy of the enhanced metafile
Enumerate the colors in the optional palette
Convert an enhanced-format metafile into a Windows-format metafile

When the application no longer needs the enhanced metafile handle, it should release the handle by calling the DeleteEnhMetaFile function.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	wingdi.h (include Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll