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

Notifica o provedor de Automação da Interface do Usuário da Microsoft quando um cliente Automação da Interface do Usuário começa a escutar um evento específico, incluindo um evento de alteração de propriedade.

Sintaxe

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

Parâmetros

[in] eventId

Tipo: EVENTID

O identificador do evento sendo adicionado. Para obter uma lista de IDs de evento, consulte Identificadores de evento.

[in] propertyIDs

Tipo: SAFEARRAY*

Um ponteiro para os identificadores das propriedades que estão sendo adicionadas ou NULL se o ouvinte de eventos que está sendo adicionado não estiver escutando eventos de propriedade.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método permite que o provedor reduza a sobrecarga gerando apenas eventos que estão sendo escutados.

É importante que Automação da Interface do Usuário provedores tratem o IRawElementProviderAdviseEvents::AdviseEventAdded como o método AddRef da interface IUnknown. Desde que AdviseEventAdded tenha sido chamado mais vezes do que AdviseEventRemoved para um evento ou propriedade específico, o provedor deve continuar a gerar eventos correspondentes, pois alguns clientes ainda estão escutando. Como alternativa, Automação da Interface do Usuário provedores podem usar a função UiaClientsAreListening para determinar se pelo menos um cliente está escutando e, em caso afirmativo, gerar todos os eventos apropriados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcore.h (include UIAutomation.h)

Confira também

Práticas recomendadas para usar matrizes seguras

Conceitual

IRawElementProviderAdviseEvents

Referência