CopyEnhMetaFileW 函数 (wingdi.h)

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

语法

HENHMETAFILE CopyEnhMetaFileW(
  [in] HENHMETAFILE hEnh,
  [in] LPCWSTR      lpFileName
);

参数

[in] hEnh

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

[in] lpFileName

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

返回值

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

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

注解

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

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

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

注意

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

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

DeleteEnhMetaFile

图元文件函数

图元文件概述