getIconInfoExA 函数 (winuser.h)

检索有关指定图标或光标的信息。 GetIconInfoEx 使用更新的 ICONINFOEX 结构扩展 GetIconInfo。

语法

BOOL GetIconInfoExA(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXA piconinfo
);

参数

[in] hicon

类型： HICON

图标或光标的句柄。

若要检索有关标准图标或游标的信息，请在此参数中指定 以IDI_前缀开头 的 标识符或以IDC_前缀开头的标识符 。

[in, out] piconinfo

类型： PICONINFOEX

此方法返回时，包含指向 ICONINFOEX 结构的指针。 函数填充结构的成员。

返回值

类型： BOOL

TRUE 表示成功， FALSE 表示失败。

注解

GetIconInfoEx 为 hbmMask 和 hbmColor 或 ICONINFOEX 的成员创建位图。 调用应用程序必须管理这些位图，并在不再需要时使用 DeleteObject 调用将其删除。

DPI 虚拟化

此 API 不参与 DPI 虚拟化。 返回的输出不受调用线程的 DPI 影响。

注意

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

要求

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

请参阅

概念性

位图

图标

DeleteObject

GetObject

BITMAP

CreateIcon

CreateIconFromResource

CreateIconIndirect

DestroyIcon

DrawIcon

DrawIconEx

LoadIcon

LookupIconIdFromDirectory

ICONINFO