CopyMetaFileA 函数 (wingdi.h)

CopyMetaFile 函数将 Windows 格式图元文件的内容复制到指定文件。

注意提供此函数仅用于与 Windows 格式图元文件的兼容性。增强格式的图元文件提供卓越的功能，建议用于新应用程序。增强格式图元文件的相应函数是 CopyEnhMetaFile。

语法

HMETAFILE CopyMetaFileA(
  [in] HMETAFILE unnamedParam1,
  [in] LPCSTR    unnamedParam2
);

[in] unnamedParam1

源 Windows 格式图元文件的句柄。

[in] unnamedParam2

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

如果函数成功，则返回值是 Windows 格式图元文件副本的句柄。

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

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

当应用程序不再需要 Windows 格式的图元文件句柄时，它应通过调用 DeleteMetaFile 函数删除句柄。

注意

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

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