Функция DestroyIcon (winuser.h)
Уничтожает значок и освобождает память, занятую значком.
Синтаксис
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) |
См. также раздел
Основные понятия
Справочные материалы