Función GetCursorPos (winuser.h)

Artículo
03/04/2024

Recupera la posición del cursor del mouse, en coordenadas de pantalla.

Sintaxis

BOOL GetCursorPos(
  [out] LPPOINT lpPoint
);

Parámetros

[out] lpPoint

Tipo: LPPOINT

Puntero a una estructura POINT que recibe las coordenadas de pantalla del cursor.

Valor devuelto

Tipo: BOOL

Devuelve un valor distinto de cero si es correcto o cero de lo contrario. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La posición del cursor siempre se especifica en coordenadas de pantalla y no se ve afectada por el modo de asignación de la ventana que contiene el cursor.

El proceso de llamada debe tener WINSTA_READATTRIBUTES acceso a la estación de ventanas.

El escritorio de entrada debe ser el escritorio actual al llamar a GetCursorPos. Llame a OpenInputDesktop para determinar si el escritorio actual es el escritorio de entrada. Si no es así, llame a SetThreadDesktop con el HDESK devuelto por OpenInputDesktop para cambiar a ese escritorio.

Ejemplos

Para obtener un ejemplo, vea Usar el teclado para mover el cursor.

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 (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-2 (introducido en Windows 10, versión 10.0.10240)