GetCursorPos 함수(winuser.h)

아티클
08/27/2023

화면 좌표에서 마우스 커서의 위치를 검색합니다.

구문

BOOL GetCursorPos(
  [out] LPPOINT lpPoint
);

매개 변수

[out] lpPoint

형식: LPPOINT

커서의 화면 좌표를 수신하는 POINT 구조체에 대한 포인터입니다.

반환 값

형식: BOOL

성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

커서 위치는 항상 화면 좌표로 지정되며 커서가 포함된 창의 매핑 모드에는 영향을 받지 않습니다.

호출 프로세스에는 창 스테이션에 대한 WINSTA_READATTRIBUTES 액세스 권한이 있어야 합니다.

GetCursorPos를 호출할 때 입력 데스크톱은 현재 데스크톱이어야 합니다. OpenInputDesktop을 호출하여 현재 데스크톱이 입력 데스크톱인지 확인합니다. 그렇지 않은 경우 OpenInputDesktop에서 반환한 HDESK를 사용하여 SetThreadDesktop을 호출하여 해당 데스크톱으로 전환합니다.

예제

예제는 키보드를 사용하여 커서 이동을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-window-l1-1-2(Windows 10 버전 10.0.10240에 도입됨)