IUIAutomation6::RemoveEventHandlerGroup-Methode (uiautomationclient.h)

  • Artikel

Entfernt asynchron die angegebene Benutzeroberflächenautomatisierung Ereignishandlergruppe.

Syntax

HRESULT RemoveEventHandlerGroup(
  [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 abgekündigt wurde, wenn das Ereignis gleichzeitig mit der Anforderung zum Abbestellen des Ereignisses empfangen wird. 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 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::AddEventHandlerGroup, IUIAutomation6-Schnittstelle