Metodo IUIAutomation::RemoveAutomationEventHandler (uiautomationclient.h)

  • Articolo

Rimuove il gestore eventi Automazione interfaccia utente specificato.

Sintassi

HRESULT RemoveAutomationEventHandler(
  [in] EVENTID                   eventId,
  [in] IUIAutomationElement      *element,
  [in] IUIAutomationEventHandler *handler
);

Parametri

[in] eventId

Tipo: EVENTID

Identificatore dell'evento gestito. Per un elenco di ID evento, vedere Identificatori di eventi.

[in] element

Tipo: IUIAutomationElement*

Puntatore all'elemento Automazione interfaccia utente che gestisce l'evento.

[in] handler

Tipo: IUIAutomationEventHandler*

Puntatore al metodo del gestore passato a IUIAutomation::AddAutomationEventHandler per l'identificatore di evento e l'elemento Automazione interfaccia utente specificati.

Valore restituito

Tipo: HRESULT

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

Commenti

Un client Automazione interfaccia utente non deve usare più thread per aggiungere o rimuovere gestori eventi. Il comportamento imprevisto può causare se un gestore eventi viene aggiunto o rimosso mentre un altro viene aggiunto o rimosso nello stesso processo client.

È possibile che un evento venga recapitato a un gestore eventi dopo la sottoscrizione del gestore, se l'evento viene ricevuto simultaneamente con la richiesta di annullare la sottoscrizione dell'evento. La procedura consigliata consiste nel seguire lo standard Component Object Model (COM) ed evitare di distruggere l'oggetto gestore eventi fino a quando il numero di 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 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uiautomationclient.h (includere UIAutomation.h)

Vedi anche

IUIAutomation

RemoveAllEventHandlers

RemoveFocusChangedEventHandler

RemovePropertyChangedEventHandler

RemoveStructureChangedEventHandler