Aufheben der RegistrierungPointerInputTarget-Funktion (winuser.h)

Artikel
08/28/2023

Ermöglicht dem Aufrufer das Aufheben der Registrierung eines Zielfensters, an das alle Zeigereingaben des angegebenen Typs weitergeleitet werden.

Syntax

BOOL UnregisterPointerInputTarget(
  [in] HWND               hwnd,
  [in] POINTER_INPUT_TYPE pointerType
);

Parameter

[in] hwnd

Fenster, das als globales Umleitungsziel auf dem Desktop nicht registriert werden soll.

[in] pointerType

Art der Zeigereingabe, die nicht mehr an das angegebene Fenster umgeleitet werden soll. Dies ist ein beliebiger gültiger und unterstützter Wert aus der POINTER_INPUT_TYPE-Enumeration . Beachten Sie, dass der generische PT_POINTER-Typ und der PT_MOUSE-Typ in diesem Parameter ungültig sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich 0.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Eine Anwendung, die die Funktion RegisterPointerInputTarget erfolgreich aufgerufen hat, kann diese Funktion aufrufen, um die Registrierung des Fensters aus der Rolle des global umgeleiteten Ziels für den angegebenen Zeigertyp aufzuheben.

Eine Anwendung, die dasselbe Fenster als globales Umleitungsziel für mehrere Zeigereingabetypen registriert hat, kann unregisterPointerInputTarget aufrufen, um die Registrierung des Fensters für einen dieser Typen aufzuheben, während das Fenster für die verbleibenden Typen registriert bleibt.

Wenn der aufrufende Thread nicht über die Benutzeroberflächenzugriffsberechtigung verfügt, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_ACCESS_DENIED festgelegt ist.

Wenn der angegebene Zeigereingabetyp ungültig ist, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_INVALID_PARAMETER festgelegt ist.

Wenn der aufrufende Thread nicht im Besitz des angegebenen Fensters ist, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_ACCESS_DENIED festgelegt ist.

Wenn das angegebene Fenster nicht das registrierte globale Umleitungsziel für den angegebenen Zeigereingabetyp auf dem Desktop ist, führt diese Funktion keine Aktion aus und gibt einen Erfolg zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll

Share via