CloseMetaFile function (wingdi.h)

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

Note  This function is provided only for compatibility with Windows-format metafiles. Enhanced-format metafiles provide superior functionality and are recommended for new applications. The corresponding function for an enhanced-format metafile is CloseEnhMetaFile.
 

Syntax

HMETAFILE CloseMetaFile(
  [in] HDC hdc
);

Parameters

[in] hdc

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

Return value

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

If the function fails, the return value is NULL.

Remarks

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.

Requirements

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

See also

CloseEnhMetaFile

CopyMetaFile

CreateMetaFile

DeleteMetaFile

EnumMetaFile

GetMetaFileBitsEx

Metafile Functions

Metafiles Overview

PlayMetaFile

SetWinMetaFileBits