DestroyIcon, fonction (winuser.h)
Détruit une icône et libère toute la mémoire occupée par l’icône.
Syntaxe
BOOL DestroyIcon(
[in] HICON hIcon
);
Paramètres
[in] hIcon
Type : HICON
Handle de l’icône à détruire. L’icône ne doit pas être utilisée.
Valeur retournée
Type : BOOL
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Il est nécessaire d’appeler DestroyIcon uniquement pour les icônes et les curseurs créés avec les fonctions suivantes : CreateIconFromResourceEx (s’il est appelé sans l’indicateur LR_SHARED ), CreateIconIndirect et CopyIcon. N’utilisez pas cette fonction pour détruire une icône partagée. Une icône partagée est valide tant que le module à partir duquel elle a été chargée reste en mémoire. Les fonctions suivantes obtiennent une icône partagée.
- LoadIcon
- LoadImage (si vous utilisez l’indicateur LR_SHARED )
- CopyImage (si vous utilisez l’indicateur LR_COPYRETURNORG et que le paramètre hImage est une icône partagée)
- CreateIconFromResource
- CreateIconFromResourceEx (si vous utilisez l’indicateur LR_SHARED )
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |
| Ensemble d’API | ext-ms-win-ntuser-gui-l1-1-0 (introduit dans Windows 8) |
Voir aussi
Conceptuel
Référence