Método IUIAutomation::RemoveStructureChangedEventHandler (uiautomationclient.h)
Quita un controlador de eventos modificado por la estructura.
Sintaxis
HRESULT RemoveStructureChangedEventHandler(
[in] IUIAutomationElement *element,
[in] IUIAutomationStructureChangedEventHandler *handler
);
Parámetros
[in] element
Tipo: IUIAutomationElement*
Puntero al elemento de Automatización de la interfaz de usuario del que se va a quitar el controlador.
[in] handler
Tipo: IUIAutomationStructureChangedEventHandler*
Puntero a la interfaz que se pasó a IUIAutomation::AddStructureChangedEventHandler.
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
| 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) |