Método IUIAutomation::RemoveAutomationEventHandler (uiautomationclient.h)
Quita el controlador de eventos de Automatización de la interfaz de usuario especificado.
Sintaxis
HRESULT RemoveAutomationEventHandler(
[in] EVENTID eventId,
[in] IUIAutomationElement *element,
[in] IUIAutomationEventHandler *handler
);
Parámetros
[in] eventId
Tipo: EVENTID
Identificador del evento que se está controlando. Para obtener una lista de identificadores de eventos, consulte Identificadores de eventos.
[in] element
Tipo: IUIAutomationElement*
Puntero al elemento Automatización de la interfaz de usuario que controla el evento.
[in] handler
Tipo: IUIAutomationEventHandler*
Puntero al método de controlador que se pasó a IUIAutomation::AddAutomationEventHandler para el identificador de evento especificado y Automatización de la interfaz de usuario elemento.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Un cliente de Automatización de la interfaz de usuario no debe usar varios subprocesos para agregar o quitar controladores de eventos. Un comportamiento inesperado puede dar lugar a que se agregue o quite un controlador de eventos mientras se agrega o se quita otro en el mismo proceso de cliente.
Es posible que un evento se entregue a un controlador de eventos después de cancelar la suscripción del controlador, si el evento se recibe simultáneamente con la solicitud de cancelar la suscripción del evento. El procedimiento recomendado es seguir el estándar Modelo de objetos componentes (COM) y evitar destruir el objeto del controlador de eventos hasta que su recuento de referencias haya alcanzado cero. La destrucción de un controlador de eventos inmediatamente después de cancelar la suscripción de eventos puede provocar una infracción de acceso si un evento se entrega en tiempo de espera.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista, Windows XP con SP3 y Actualización de plataforma para Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | uiautomationclient.h (include UIAutomation.h) |
Consulte también
RemoveFocusChangedEventHandler