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 [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

DeleteMetaFile

图元文件函数

图元文件概述