DestroyCursor-Funktion (winuser.h)
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 |
Siehe auch
Konzept
Referenz