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

Статья
08/26/2023

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

Синтаксис

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 , чтобы определить, прослушивает ли хотя бы один клиент, и, если да, вызывает все соответствующие события.

Требования


Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	uiautomationcore.h (включая UIAutomation.h)

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

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

IRawElementProviderAdviseEvents

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

Share via