Funzione DestroyCursor (winuser.h)

Articolo
03/13/2024

Elimina un cursore e libera qualsiasi memoria occupata dal cursore. Non usare questa funzione per eliminare definitivamente un cursore condiviso.

Sintassi

BOOL DestroyCursor(
  [in] HCURSOR hCursor
);

Parametri

[in] hCursor

Tipo: HCURSOR

Handle per il cursore da eliminare definitivamente. Il cursore non deve essere in uso.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione DestroyCursor elimina definitivamente un cursore non condiviso. Non usare questa funzione per eliminare definitivamente un cursore condiviso. Un cursore condiviso è valido finché il modulo da cui è stato caricato rimane in memoria. Le funzioni seguenti ottengono un cursore condiviso:

LoadCursor
LoadCursorFromFile
LoadImage (se si usa il flag di LR_SHARED )
CopyImage (se si usa il flag LR_COPYRETURNORG e il parametro hImage è un cursore condiviso)

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll