DestroyIcon-Funktion (winuser.h)

Artikel
08/27/2023

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)