Fonction DestroyCursor (winuser.h)

Article
03/04/2024

Détruit un curseur et libère toute mémoire occupée par le curseur. N’utilisez pas cette fonction pour détruire un curseur partagé.

Syntaxe

BOOL DestroyCursor(
  [in] HCURSOR hCursor
);

Paramètres

[in] hCursor

Type : HCURSOR

Poignée du curseur à détruire. Le curseur ne doit pas être utilisé.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction DestroyCursor détruit un curseur non partagé. N’utilisez pas cette fonction pour détruire un curseur partagé. Un curseur partagé est valide tant que le module à partir duquel il a été chargé reste en mémoire. Les fonctions suivantes obtiennent un curseur partagé :

LoadCursor
LoadCursorFromFile
LoadImage (si vous utilisez l’indicateur LR_SHARED )
CopyImage (si vous utilisez l’indicateur LR_COPYRETURNORG et que le paramètre hImage est un curseur partagé)

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll