CloseMetaFile

The CloseMetaFile function closes a metafile device context and returns a handle that identifies a Windows-format metafile.

Note  This function is provided for compatibility with 16-bit versions of Windows. Win32-based applications should use the CloseEnhMetaFile function.

HMETAFILE CloseMetaFile(
  HDC hdc   // handle to metafile device context
);
 

Parameters

hdc

Handle to a metafile device context used to create a Windows-format metafile.

Return Values

If the function succeeds, the return value is a handle to a Windows-format metafile.

If the function fails, the return value is NULL.

Windows NT: To get extended error information, call GetLastError.

Remarks

A Windows-format metafile does not support the new curve, path, and transformation functions, such as PolyBezier, BeginPath, and SetWorldTransform. Applications that use these new functions and use metafiles to store pictures created by these functions should call the enhanced-format metafile functions.

To convert a Windows-format metafile into a new enhanced-format metafile, use the SetWinMetaFileBits function.

When an application no longer needs the Windows-format metafile handle, it should delete the handle by calling the DeleteMetaFile function.

See Also

Metafiles Overview, Metafile Functions, BeginPath, CloseEnhMetaFile, CopyMetaFile, CreateMetaFile, DeleteMetaFile, EnumMetaFile, GetMetaFileBitsEx, PlayMetaFile, PolyBezier, SetWinMetaFileBits, SetWorldTransform