getEnhMetaFileBits 函数 (wingdi.h)

GetEnhMetaFileBits 函数检索指定增强格式图元文件的内容,并将其复制到缓冲区中。

语法

UINT GetEnhMetaFileBits(
  [in]  HENHMETAFILE hEMF,
  [in]  UINT         nSize,
  [out] LPBYTE       lpData
);

参数

[in] hEMF

增强型图元文件的句柄。

[in] nSize

要接收数据的缓冲区的大小(以字节为单位)。

[out] lpData

指向接收图元文件数据的缓冲区的指针。 缓冲区必须足够大才能包含数据。 如果 lpbBufferNULL,则该函数将返回保存数据所需的大小。

返回值

如果函数成功且缓冲区指针为 NULL,则返回值是增强型图元文件的大小(以字节为单位)。

如果函数成功,并且缓冲区指针是有效的指针,则返回值是复制到缓冲区的字节数。

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

注解

检索增强型图元文件位后,可以使用它们通过调用 SetEnhMetaFileBits 函数来创建基于内存的图元文件。

GetEnhMetaFileBits 函数不会使增强型图元文件句柄失效。 当不再需要句柄时,应用程序必须调用 DeleteEnhMetaFile 函数来删除该句柄。

此函数检索的图元文件内容采用增强格式。 若要检索 Windows 格式的图元文件内容,请使用 GetWinMetaFileBits 函数。

要求

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

另请参阅

DeleteEnhMetaFile

GetWinMetaFileBits

图元文件函数

图元文件概述

SetEnhMetaFileBits