CopyEnhMetaFile

HENHMETAFILE CopyEnhMetaFile(hemfSrc, lpszFile)
HENHMETAFILE hemfSrc;	/* handle of an enhanced metafile	*/
LPTSTR lpszFile;	/* address of a filename string	*/

The CopyEnhMetaFile function copies the contents of the enhanced metafile identified by hemfSrc to the file that is identified by lpszFile.

Parameters

hemfSrc

Identifies the source enhanced metafile.

lpszFile

Points to the filename of the file that is to receive the enhanced metafile. If NULL, the metafile is copied to memory.

Return Value

The return value identifies a copy of the enhanced metafile if the function is successful. Otherwise, it is NULL. Use the GetLastError function to obtain extended error information.

Comments

This function may be used as either a wide-character function (where text arguments must use Unicode) or an ANSI function (where text arguments must use characters from the Windows 3.x character set).

If lpszFile is NULL, the metafile is copied to memory; otherwise it is copied to disk. Applications can use metafiles stored in memory for temporary operations.

An application should delete an enhanced metafile once it is no longer needed by calling the DeleteEnhMetaFile function.