Condividi tramite


Funzione DestroyIcon (winuser.h)

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.

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)

Vedi anche

Informazioni concettuali

CopyIcon

CreateIconFromResource

CreateIconFromResourceEx

CreateIconIndirect

Icone

Riferimento