CopyMetaFileA function

The CopyMetaFile function copies the content of a Windows-format metafile to the specified file.

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 CopyEnhMetaFile.
 

Syntax

HMETAFILE CopyMetaFileA(
  HMETAFILE ,
  LPCSTR    
);

Parameters

arg1

A handle to the source Windows-format metafile.

arg2

A pointer to the name of the destination file. If this parameter is NULL, the source metafile is copied to memory.

Return Value

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

If the function fails, the return value is NULL.

Remarks

Where text arguments must use Unicode characters, use this function as a wide-character function. Where text arguments must use characters from the Windows character set, use this function as an ANSI function.

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

Requirements

   
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

DeleteMetaFile

Metafile Functions

Metafiles Overview