Метод IRawElementProviderAdviseEvents::AdviseEventRemoved (uiautomationcore.h)

Уведомляет поставщика автоматизации пользовательского интерфейса Майкрософт, когда клиент автоматизации пользовательского интерфейса перестает прослушивать определенное событие, включая событие изменения свойства.

Синтаксис

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

Параметры

[in] eventId

Тип: EVENTID

Идентификатор удаляемого события. Список идентификаторов событий см. в разделе Идентификаторы событий.

[in] propertyIDs

Тип: SAFEARRAY*

Указатель на идентификаторы удаляемых свойств или значение NULL , если удаляемый прослушиватель событий не прослушивает события свойства.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод позволяет поставщику сократить затраты, вызывая только события, которые прослушиваются.

Поставщики автоматизации пользовательского интерфейса должны обрабатывать IRawElementProviderAdviseEvents::AdviseEventRemoved как метод Release интерфейса IUnknown . До тех пор, пока функция AdviseEventAdded вызывается больше раз, чем AdviseEventRemoved для определенного события или свойства, поставщик должен продолжать вызывать соответствующие события, так как некоторые клиенты по-прежнему прослушивают. Кроме того, поставщики автоматизации пользовательского интерфейса могут использовать функцию UiaClientsAreListening , чтобы определить, прослушивает ли хотя бы один клиент, и, если да, вызывает все соответствующие события.

Требования

См. также раздел

Рекомендации по использованию безопасных массивов

Основные понятия

IRawElementProviderAdviseEvents

Справочные материалы