Функция GetIconInfo (winuser.h)

Статья
03/04/2024

Извлекает сведения о указанном значке или курсоре.

Синтаксис

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 , когда они больше не нужны.

Виртуализация DPI

Этот API не участвует в виртуализации DPI. На возвращаемые выходные данные не влияет то, что значение DPI вызывающего потока не влияет.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-gui-l1-1-0 (представлено в Windows 8)