Compartir a través de

Método IRawElementProviderAdviseEvents::AdviseEventRemoved (uiautomationcore.h)

  • Artículo

Notifica al proveedor de Automatización de la interfaz de usuario de Microsoft cuando un cliente de Automatización de la interfaz de usuario deja de escuchar un evento específico, incluido un evento cambiado por propiedades.

Sintaxis

HRESULT AdviseEventRemoved(
  [in] EVENTID   eventId,
  [in] SAFEARRAY *propertyIDs
);

Parámetros

[in] eventId

Tipo: EVENTID

Identificador del evento que se va a quitar. Para obtener una lista de identificadores de eventos, consulte Identificadores de eventos.

[in] propertyIDs

Tipo: SAFEARRAY*

Puntero a los identificadores de las propiedades que se van a quitar o NULL si el agente de escucha de eventos que se quita no escucha los eventos de propiedad.

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

Este método permite al proveedor reducir la sobrecarga mediante la generación de solo eventos que se escuchan.

Es importante que los proveedores de automatización de la interfaz de usuario traten el IRawElementProviderAdviseEvents::AdviseEventRemoved como el método Release de la interfaz IUnknown . Siempre que se haya llamado a AdviseEventAdded más veces que AdviseEventRemoved para un evento o propiedad específicos, el proveedor debe seguir generando eventos correspondientes, ya que algunos clientes siguen escuchando. Como alternativa, los proveedores de automatización de la interfaz de usuario pueden usar la función UiaClientsAreListening para determinar si al menos un cliente está escuchando y, si es así, generar todos los eventos adecuados.

Requisitos

   
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado uiautomationcore.h (incluir UIAutomation.h)

Consulte también

Procedimientos recomendados para usar matrices seguras

Conceptual

IRawElementProviderAdviseEvents

Referencia