This topic has not yet been rated - Rate this topic

CopyMetaFile function

Applies to: desktop apps only

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

Copy

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