CloseEnhMetaFile function

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

Syntax

HENHMETAFILE CloseEnhMetaFile(
  HDC hdc
);

Parameters

hdc

Handle to an enhanced-metafile device context.

Return Value

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

If the function fails, the return value is NULL.

Remarks

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.

Requirements

   
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

See Also

CopyEnhMetaFile

CreateEnhMetaFile

DeleteEnhMetaFile

EnumEnhMetaFile

GetEnhMetaFileBits

GetWinMetaFileBits

Metafile Functions

Metafiles Overview

PlayEnhMetaFile