CopyMetaFileW 函数 (wingdi.h)

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

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

语法

HMETAFILE CopyMetaFileW(
  [in] HMETAFILE unnamedParam1,
  [in] LPCWSTR   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 [仅限桌面应用]
目标平台 窗户
标头 wingdi.h (包括 Windows.h)
Gdi32.lib
DLL Gdi32.dll

另请参阅

DeleteMetaFile

图元文件函数

图元文件概述