Partager via


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.

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

CopyIcon

CreateIconFromResource

CreateIconFromResourceEx

CreateIconIndirect

Icônes

Référence