Función DestroyCursor (winuser.h)

Artículo
08/27/2023

Destruye un cursor y libera cualquier memoria que ocupe el cursor. No use esta función para destruir un cursor compartido.

Sintaxis

BOOL DestroyCursor(
  [in] HCURSOR hCursor
);

Parámetros

[in] hCursor

Tipo: HCURSOR

Identificador del cursor que se va a destruir. El cursor no debe estar en uso.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función DestroyCursor destruye un cursor no compartido. No use esta función para destruir un cursor compartido. Un cursor compartido es válido siempre que el módulo desde el que se cargó permanece en la memoria. Las siguientes funciones obtienen un cursor compartido:

LoadCursor
LoadCursorFromFile
LoadImage (si usa la marca LR_SHARED )
CopyImage (si usa la marca LR_COPYRETURNORG y el parámetro hImage es un cursor compartido)

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll