Metodo IUIAutomation::RemoveStructureChangedEventHandler (uiautomationclient.h)
Rimuove un gestore eventi modificato dalla struttura.
Sintassi
HRESULT RemoveStructureChangedEventHandler(
[in] IUIAutomationElement *element,
[in] IUIAutomationStructureChangedEventHandler *handler
);
Parametri
[in] element
Tipo: IUIAutomationElement*
Puntatore all'elemento Automazione interfaccia utente da cui rimuovere il gestore.
[in] handler
Tipo: IUIAutomationStructureChangedEventHandler*
Puntatore all'interfaccia passata a IUIAutomation::AddStructureChangedEventHandler.
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. Un comportamento imprevisto può determinare se un gestore eventi viene aggiunto o rimosso mentre viene aggiunto o rimosso nello stesso processo client.
È 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
| 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 (include UIAutomation.h) |