DestroyIcon-Funktion (winuser.h)
Zerstört ein Symbol und gibt den Speicher frei, den das Symbol belegt hat.
Syntax
BOOL DestroyIcon(
[in] HICON hIcon
);
Parameter
[in] hIcon
Typ: HICON
Ein Handle für das zu zerstörende Symbol. Das Symbol darf nicht verwendet werden.
Rückgabewert
Typ: BOOL
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Es ist nur erforderlich, DestroyIcon für Symbole und Cursor aufzurufen, die mit den folgenden Funktionen erstellt wurden: CreateIconFromResourceEx (wenn ohne das LR_SHARED-Flag aufgerufen), CreateIconIndirect und CopyIcon. Verwenden Sie diese Funktion nicht, um ein freigegebenes Symbol zu zerstören. Ein freigegebenes Symbol ist gültig, solange das Modul, aus dem es geladen wurde, im Arbeitsspeicher verbleibt. Die folgenden Funktionen erhalten ein freigegebenes Symbol.
- LoadIcon
- LoadImage (wenn Sie das LR_SHARED-Flag verwenden)
- CopyImage (wenn Sie das flag LR_COPYRETURNORG verwenden und der hImage-Parameter ein freigegebenes Symbol ist)
- CreateIconFromResource
- CreateIconFromResourceEx (wenn Sie das flag LR_SHARED verwenden)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-gui-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzept
Referenz