# Function Reference

# _WinAPI_CopyEnhMetaFile

Copies the contents of an enhanced-format metafile to a specified file

#include <WinAPIGdi.au3>
_WinAPI_CopyEnhMetaFile ( $hEmf [, $sFilePath = ''] )

## Parameters

$hEmf | Handle to the enhanced metafile to be copied.
$sFilePath | [optional] The name of the destination file (.emf). If this parameter is '' (Default), the source metafile is copied to memory.

## Return Value

Success: | Handle to the copy of the enhanced metafile.
Failure: | 0.

## Remarks

When the application no longer needs an enhanced-metafile handle, it should delete the handle by calling the
_WinAPI_DeleteEnhMetaFile() function.

## Related

_WinAPI_DeleteEnhMetaFile

## See Also

Search CopyEnhMetaFile in MSDN Library.