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.
- 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) |
Vedi anche
Informazioni concettuali
Riferimento