CopyMetaFile 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 CopyMetaFile(
  _In_ HMETAFILE hmfSrc,
  _In_ LPCTSTR   lpszFile
);

Parameters

hmfSrc [in]

A handle to the source Windows-format metafile.

lpszFile [in]

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]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

Unicode and ANSI names

CopyMetaFileW (Unicode) and CopyMetaFileA (ANSI)

See also

Metafiles Overview
Metafile Functions
DeleteMetaFile

 

 

Show: