Metodo IUIAutomation6::RemoveEventHandlerGroup (uiautomationclient.h)

Articolo
03/13/2024

Rimuove in modo asincrono il gruppo di gestori eventi Automazione interfaccia utente specificato.

Sintassi

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

Parametri

[in] element

Puntatore all'elemento Automazione interfaccia utente associato al gruppo di gestori eventi.

handlerGroup

Raccolta di listener di eventi di Automazione interfaccia utente.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Commenti

Prima di implementare un gestore eventi, è necessario avere familiarità con i problemi di threading descritti in Informazioni sui problemi di threading.

È possibile che un evento venga recapitato a un gestore eventi dopo che il gestore è stato annullato, se l'evento viene ricevuto contemporaneamente con la richiesta di annullare la sottoscrizione dell'evento. La procedura consigliata consiste nel seguire lo standard COM (Component Object Model) ed evitare di eliminare definitivamente l'oggetto gestore eventi fino a quando il conteggio dei riferimenti non ha raggiunto zero. L'eliminazione di un gestore eventi immediatamente dopo l'annullamento della sottoscrizione per gli eventi può causare una violazione di accesso se un evento viene recapitato in ritardo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1809 [solo app desktop]
Server minimo supportato	Windows Server, versione 1709 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (include UIAutomation.h)

Vedi anche

Interfaccia IUIAutomation6::AddEventHandlerGroup, IUIAutomation6

Condividi tramite