Método IUIAutomation6::AddEventHandlerGroup (uiautomationclient.h)

Registra una colección de métodos de controlador de eventos especificados con IUIAutomation6::CreateEventHandlerGroup.

Importante

Los clientes de Microsoft Automatización de la interfaz de usuario deben usar los métodos de grupo de controladores para registrar agentes de escucha de eventos en lugar de métodos de registro de eventos individuales definidos en los distintos espacios de nombres de la interfaz IUIAutomation.

Sintaxis

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

Parámetros

[in] element

Puntero al elemento Automatización de la interfaz de usuario asociado al grupo de controladores de eventos.

handlerGroup

Colección de Automatización de la interfaz de usuario agentes de escucha de eventos.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Observaciones

Antes de implementar un controlador de eventos, debe estar familiarizado con los problemas de subprocesos descritos en Descripción de los problemas de subprocesos.

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 10, versión 1809 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server, versión 1709 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomation6::RemoveEventHandlerGroup, interfaz IUIAutomation6