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 |