DestroyCursor-Funktion (winuser.h)

Artikel
03/06/2024

Zerstört einen Cursor und gibt den vom Cursor belegten Arbeitsspeicher frei. Verwenden Sie diese Funktion nicht, um einen freigegebenen Cursor zu zerstören.

Syntax

BOOL DestroyCursor(
  [in] HCURSOR hCursor
);

Parameter

[in] hCursor

Typ: HCURSOR

Ein Handle für den zu zerstörenden Cursor. Der Cursor 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

Die DestroyCursor-Funktion zerstört einen nicht freigegebenen Cursor. Verwenden Sie diese Funktion nicht, um einen freigegebenen Cursor zu zerstören. Ein freigegebener Cursor ist gültig, solange das Modul, aus dem er geladen wurde, im Arbeitsspeicher verbleibt. Die folgenden Funktionen rufen einen freigegebenen Cursor ab:

LoadCursor
LoadCursorFromFile
LoadImage (wenn Sie das flag LR_SHARED verwenden)
CopyImage (wenn Sie das flag LR_COPYRETURNORG verwenden und der hImage-Parameter ein freigegebener Cursor ist)

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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll