Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CloseEnhMetaFile function

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
);

Parameters

hdc [in]

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]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Metafiles Overview
Metafile Functions
CopyEnhMetaFile
CreateEnhMetaFile
DeleteEnhMetaFile
EnumEnhMetaFile
GetEnhMetaFileBits
GetWinMetaFileBits
PlayEnhMetaFile

 

 

Show: