OleMetafilePictFromIconAndLabel 函数 (ole2.h)

创建在其中绘制指定图标和标签的图元文件。

语法

HGLOBAL OleMetafilePictFromIconAndLabel(
  [in] HICON    hIcon,
  [in] LPOLESTR lpszLabel,
  [in] LPOLESTR lpszSourceFile,
  [in] UINT     iIconIndex
);

参数

[in] hIcon

要绘制到图元文件中的图标的句柄。 此参数可以为 NULL。 如果 hIconNULL,则此函数返回 NULL 而不创建图元文件。

[in] lpszLabel

图标标签。 此参数可以为 NULL。 如果 lpszLabelNULL,则生成的图元文件将不包含标签。

[in] lpszSourceFile

图标文件的路径和文件名。 可以通过用户界面或注册数据库获取此字符串。 此参数可以为 NULL。

[in] iIconIndex

图标在由 lpszSourceFile 命名的文件中的位置,表示为与文件开头的偏移量(以字节为单位)。

返回值

包含图标和标签的 METAFILEPICT 结构的全局句柄。 图元文件使用MM_ANISOTROPIC映射模式。

如果发生错误,则返回的句柄为 NULL。 在这种情况下,调用方可以调用 GetLastError 以获取更多信息。

注解

此函数由 OleGetIconOfFileOleGetIconOfClass 调用

如果 lpszSourceFile为 NULLiIconIndex 不为 0,则将在 lpszSourceFile 中传递的源文件的名称和 iIconIndex 传递的索引作为注释记录添加到创建的图元文件中。

要求

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

另请参阅

OleGetIconOfClass

OleGetIconOfFile