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

Voir aussi

Conceptuel

CopyIcon

CreateIconFromResource

CreateIconFromResourceEx

CreateIconIndirect

Icônes

Référence