CopyEnhMetaFileA 函数（wingdi.h）

CopyEnhMetaFile 函数将增强格式图元文件的内容复制到指定文件。

语法

HENHMETAFILE CopyEnhMetaFileA(
  [in] HENHMETAFILE hEnh,
  [in] LPCSTR       lpFileName
);

[in] hEnh

要复制的增强图元文件的句柄。

[in] lpFileName

指向目标文件名称的指针。如果此参数 NULL，则源图元文件将复制到内存中。

如果函数成功，则返回值是增强型图元文件副本的句柄。

如果函数失败，则返回值 NULL。

如果文本参数必须使用 Unicode 字符，请使用 CopyEnhMetaFile 函数作为宽字符函数。如果文本参数必须使用 Windows 字符集中的字符，请将此函数用作 ANSI 函数。

应用程序可以使用内存中存储的图元文件执行临时操作。

当应用程序不再需要增强型图元文件句柄时，应通过调用 DeleteEnhMetaFile 函数来删除句柄。

注意

wingdi.h 标头将 CopyEnhMetaFile 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	wingdi.h （包括 Windows.h）
库	Gdi32.lib
DLL	Gdi32.dll