Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

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

Feedback

Was this page helpful?

Additional resources

  • Last updated on