UnregisterPointerInputTarget, fonction (winuser.h)

Article
08/28/2023

Permet à l’appelant d’annuler l’inscription d’une fenêtre cible vers laquelle toutes les entrées de pointeur du type spécifié sont redirigées.

Syntaxe

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

Paramètres

[in] hwnd

Fenêtre de non-inscription en tant que cible de redirection globale sur son bureau.

[in] pointerType

Type d’entrée de pointeur à ne plus rediriger vers la fenêtre spécifiée. Il s’agit de toute valeur valide et prise en charge de l’énumération POINTER_INPUT_TYPE . Notez que le type PT_POINTER générique et le type PT_MOUSE ne sont pas valides dans ce paramètre.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Une application qui a correctement appelé la fonction RegisterPointerInputTarget peut appeler cette fonction pour annuler l’inscription de la fenêtre du rôle de cible redirigée globale pour le type de pointeur spécifié.

Une application qui a inscrit la même fenêtre qu’une cible de redirection globale pour plusieurs types d’entrée de pointeur peut appeler UnregisterPointerInputTarget pour annuler l’inscription de la fenêtre pour l’un de ces types tout en laissant la fenêtre inscrite pour les autres types.

Si le thread appelant n’a pas le privilège d’accès à l’interface utilisateur, cette fonction échoue avec la dernière erreur définie sur ERROR_ACCESS_DENIED.

Si le type d’entrée de pointeur spécifié n’est pas valide, cette fonction échoue avec la dernière erreur définie sur ERROR_INVALID_PARAMETER.

Si le thread appelant ne possède pas la fenêtre spécifiée, cette fonction échoue avec la dernière erreur définie sur ERROR_ACCESS_DENIED.

Si la fenêtre spécifiée n’est pas la cible de redirection globale inscrite pour le type d’entrée de pointeur spécifié sur son bureau, cette fonction n’effectue aucune action et retourne la réussite.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll

Partager via