Funzione DestroyIcon (winuser.h)

Articolo
03/13/2024

Distrugge un'icona e libera qualsiasi memoria occupata dall'icona.

Sintassi

BOOL DestroyIcon(
  [in] HICON hIcon
);

Parametri

[in] hIcon

Tipo: HICON

Handle per l'icona da distruggere. L'icona non deve essere in uso.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

È necessario chiamare DestroyIcon solo per le icone e i cursori creati con le funzioni seguenti: CreateIconFromResourceEx (se chiamato senza il flag LR_SHARED ), CreateIconIndirect e CopyIcon. Non usare questa funzione per eliminare definitivamente un'icona condivisa. Un'icona condivisa è valida finché il modulo da cui è stato caricato rimane in memoria. Le funzioni seguenti ottengono un'icona condivisa.

LoadIcon
LoadImage (se si usa il flag di LR_SHARED )
CopyImage (se si usa il flag LR_COPYRETURNORG e il parametro hImage è un'icona condivisa)
CreateIconFromResource
CreateIconFromResourceEx (se si usa il flag di LR_SHARED )

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-gui-l1-1-0 (introdotto in Windows 8)