DestroyIcon, fonction (winuser.h)

Article
03/04/2024

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)