Méthode IUIAutomation6 ::RemoveEventHandlerGroup (uiautomationclient.h)

Article
08/26/2023

Supprime de manière asynchrone le groupe de gestionnaires d’événements UI Automation spécifié.

Syntaxe

HRESULT RemoveEventHandlerGroup(
  [in] IUIAutomationElement           *element,
       IUIAutomationEventHandlerGroup *handlerGroup
);

Paramètres

[in] element

Pointeur vers l’élément UI Automation associé au groupe de gestionnaires d’événements.

handlerGroup

Collection d’écouteurs d’événements UI Automation.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Avant d’implémenter un gestionnaire d’événements, vous devez être familiarisé avec les problèmes de threads décrits dans Présentation des problèmes liés aux threads.

Il est possible qu’un événement soit remis à un gestionnaire d’événements une fois que le gestionnaire a été désinscrit, si l’événement est reçu simultanément avec la demande de désinscription de l’événement. La meilleure pratique consiste à suivre la norme COM (Component Object Model) et à éviter de détruire l’objet gestionnaire d’événements tant que son nombre de références n’a pas atteint zéro. La destruction d’un gestionnaire d’événements immédiatement après la désinscripation des événements peut entraîner une violation d’accès si un événement est remis en retard.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1809 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server, version 1709 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomation6 ::AddEventHandlerGroup, interface IUIAutomation6

Partager via