GetCursorPos-Funktion (winuser.h)

Artikel
03/04/2024

Ruft die Position des Mauszeigers in Bildschirmkoordinaten ab.

Syntax

BOOL GetCursorPos(
  [out] LPPOINT lpPoint
);

Parameter

[out] lpPoint

Typ: LPPOINT

Ein Zeiger auf eine POINT-Struktur , die die Bildschirmkoordinaten des Cursors empfängt.

Rückgabewert

Typ: BOOL

Gibt ungleich null zurück, wenn erfolgreich oder andernfalls null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Cursorposition wird immer in Bildschirmkoordinaten angegeben und wird nicht vom Zuordnungsmodus des Fensters beeinflusst, das den Cursor enthält.

Der aufrufende Prozess muss über WINSTA_READATTRIBUTES Zugriff auf die Fensterstation verfügen.

Der Eingabedesktop muss der aktuelle Desktop sein, wenn Sie GetCursorPos aufrufen. Rufen Sie OpenInputDesktop auf, um zu bestimmen, ob der aktuelle Desktop der Eingabedesktop ist. Wenn nicht, rufen Sie SetThreadDesktop mit dem von OpenInputDesktop zurückgegebenen HDESK auf, um zu diesem Desktop zu wechseln.

Beispiele

Ein Beispiel finden Sie unter Verwenden der Tastatur zum Verschieben des Cursors.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240)