Compartilhar via


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

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

Sintaxe

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

Parâmetros

[in] eventId

Tipo: EVENTID

O identificador do evento que está sendo removido. 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 removidas ou NULL se o ouvinte de eventos que está sendo removido não estiver escutando eventos de propriedade.

Valor retornado

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 os provedores de Automação da Interface do Usuário tratem o IRawElementProviderAdviseEvents::AdviseEventRemoved como o método Release 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, os provedores de Automação da Interface do Usuário 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

   
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