Разрушает значок и освобождает любую память занятую значком.
Синтаксис
BOOL DestroyIcon( HICON hIcon ); |
Параметры
hIcon
[in] Дескриптор значка, который будет разрушен. Значок не должен быть в использовании.
Возвращаемое значение
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Необходимо вызывать DestroyIcon для значков и курсоров созданных только нижеследующими функциями: CreateIconFromResourceEx (если вызов без флажка LR_SHARED), CreateIconIndirect и CopyIcon. Не используйте эту функцию, чтобы разрушить совместно используемый значок. Совместно используемый значок остается действительным до тех пор, пока модуль из которого он был загружен, остается в памяти. Перечисленные ниже функции получают совместно используемый значок.
Смотри также
- LoadIcon
- LoadImage (если вы используйте флажок LR_SHARED)
- CopyImage (если вы используйте флажок LR_COPYRETURNORG, а параметр hImage - совместно используемый значок)
- CreateIconFromResource
- CreateIconFromResourceEx (если вы используйте флажок LR_SHARED)
Обзор Значки, Функции, используемые значками, CopyIcon, CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect
| Размещение и совместимость DestroyIcon | ||
| К | Windows XP | Да |
| л | Windows 2000 Professional | Да |
| и | Windows NT Workstation | Да версии 3.1 и выше |
| е | Windows Me | Да |
| н | Windows 98 | Да |
| т | Windows 95 | Да |
| С | Windows 2003 Server | Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да версии 3.1 и выше |
| в | ||
| е | ||
| р | ||
| Используемая библиотека | User32.lib | |
| Используемая DLL | user32.dll | |
| Заголовочный файл | ||
| - объявлено в | Winuser.h | |
| - включено в | Windows.h | |
| Unicode | ||
| Замечания по платформе | Не имеется | |