Функция DestroyIcon.

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

BOOL DestroyIcon(      
    HICON hIcon
);

Параметры

hIcon

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

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

В случае успеха, возвращаемое значение не равно нулю.

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

Замечания

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

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

Информация о функции

Заголовок	Объявлена в Winuser.h, включена в Windows.h
Библиотека	User32.lib
Минимальные ОС	Включена начиная с Windows 95, Windows NT 3.1