CloseEnhMetaFile  YE7QXI 

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

HENHMETAFILE CloseEnhMetaFile(

    HDC hdc

// handle to an enhanced-metafile device context

   );

 

 

Parameters

hdc

Identifies an enhanced-metafile device context.

 

Return Values

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.

See Also

CopyEnhMetaFile, CreateEnhMetaFile, DeleteEnhMetaFile, EnumEnhMetaFile, GetEnhMetaFileBits, GetWinMetaFileBits, PlayEnhMetaFile