IUIAutomation6::AddEventHandlerGroup-Methode (uiautomationclient.h)

Artikel
03/03/2024

Registriert eine Auflistung von Ereignishandlermethoden, die mit der IUIAutomation6::CreateEventHandlerGroup angegeben sind.

Wichtig

Microsoft Benutzeroberflächenautomatisierung-Clients sollten die Methoden der Handlergruppe verwenden, um Ereignislistener anstelle einzelner Ereignisregistrierungsmethoden zu registrieren, die in den verschiedenen IUIAutomation-Schnittstellennamespaces definiert sind.

Syntax

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

Parameter

[in] element

Ein Zeiger auf das Benutzeroberflächenautomatisierung Element, das der Ereignishandlergruppe zugeordnet ist.

handlerGroup

Eine Auflistung von Benutzeroberflächenautomatisierung Ereignislistenern.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Bevor Sie einen Ereignishandler implementieren, sollten Sie mit den Threadingproblemen vertraut sein, die unter Grundlegendes zu Threadingproblemen beschrieben werden.

Es ist möglich, dass ein Ereignis an einen Ereignishandler übermittelt wird, nachdem der Handler abbestellt wurde, wenn das Ereignis gleichzeitig mit der Anforderung empfangen wird, das Ereignis abzubestellen. Die bewährte Methode besteht darin, den COM-Standard (Component Object Model) zu befolgen und zu vermeiden, dass das Ereignishandlerobjekt zerstört wird, bis seine Verweisanzahl 0 (Null) erreicht hat. Das Löschen eines Ereignishandlers unmittelbar nach der Abmeldung von Ereignissen kann zu einer Zugriffsverletzung führen, wenn ein Ereignis verspätet übermittelt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server, Version 1709 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomation6::RemoveEventHandlerGroup, IUIAutomation6-Schnittstelle

Share via