CopyMetaFile
The CopyMetaFile
function copies the content of a Windows-format metafile to the specified file.
This function
is provided for compatibility with 16-bit versions of Windows. Win32-based
applications should use the CopyEnhMetaFile function.
HMETAFILE CopyMetaFile(
|
HMETAFILE hmfSrc, |
// handle to a
Windows-format metafile |
|
LPCTSTR lpszFile |
// pointer to a
filename string |
|
); |
|
Parameters
hmfSrc
Identifies
the source Windows-format metafile.
lpszFile
Points to the
name of the destination file. If this parameter is NULL, the source metafile is
copied to memory.
Return Values
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. To get extended error information,
call GetLastError.
Remarks
The CopyMetaFile
function supports only applications designed for Windows version 3.x. It
does not record or play back the new graphics device interface functions, such
as PolyBezier.
Where text
arguments must use Unicode characters, use this function as a wide-character
function. Where text arguments must use characters from the Windows 3.x
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.
See Also