Поделиться через


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

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

Синтаксис

BOOL DestroyIcon(
  [in] HICON hIcon
);

Параметры

[in] hIcon

Тип: HICON

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

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

Тип: BOOL

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

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

Комментарии

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

Требования

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

См. также раздел

Основные понятия

CopyIcon

CreateIconFromResource

CreateIconFromResourceEx

CreateIconIndirect

Значки

Справочные материалы