getIconInfo 函数 (winuser.h)

检索有关指定图标或光标的信息。

语法

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO piconinfo
);

[in] hIcon

类型： HICON

图标或光标的句柄。

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

[out] piconinfo

类型： PICONINFO

指向 ICONINFO 结构的指针。函数填充结构的成员。

类型： BOOL

如果函数成功，则返回值为非零值，并且函数将填充指定 ICONINFO 结构的成员。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

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

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

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-gui-l1-1-0 (