Freigeben über


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.

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

CopyIcon

CreateIconFromResource

CreateIconFromResourceEx

CreateIconIndirect

Symbole

Referenz