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

Статья
03/04/2024

Уничтожает значок и освобождает память, занятую значком.

Синтаксис

BOOL DestroyIcon(
  [in] HICON hIcon
);

Параметры

[in] hIcon

Тип: HICON

Дескриптор значка, который необходимо уничтожить. Значок не должен использоваться.

Возвращаемое значение

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Необходимо вызывать DestroyIcon только для значков и курсоров, созданных с помощью следующих функций: CreateIconFromResourceEx (если вызывается без флага LR_SHARED ), CreateIconIndirect и CopyIcon. Не используйте эту функцию для уничтожения общего значка. Общий значок действителен до тех пор, пока модуль, из которого он был загружен, остается в памяти. Следующие функции получают общий значок.

LoadIcon
LoadImage (если используется флаг LR_SHARED )
CopyImage (если используется флаг LR_COPYRETURNORG , а параметр hImage является общим значком)
CreateIconFromResource
CreateIconFromResourceEx (если используется флаг LR_SHARED )

Требования

Требование	Значение
Минимальная версия клиента	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)