Метод IUIAutomation::RemovePropertyChangedEventHandler (uiautomationclient.h)

Статья
08/26/2023

Удаляет обработчик событий изменения свойства.

Синтаксис

HRESULT RemovePropertyChangedEventHandler(
  [in] IUIAutomationElement                     *element,
  [in] IUIAutomationPropertyChangedEventHandler *handler
);

Параметры

[in] element

Тип: IUIAutomationElement*

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

[in] handler

Тип: IUIAutomationPropertyChangedEventHandler*

Указатель на интерфейс, переданный в IUIAutomation::AddPropertyChangedEventHandler.

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

Тип: HRESULT

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

Клиент модель автоматизации пользовательского интерфейса не должен использовать несколько потоков для добавления или удаления обработчиков событий. Непредвиденное поведение может привести к добавлению или удалению одного обработчика событий в то время как другой добавляется или удаляется в том же клиентском процессе.

Событие может быть доставлено обработчику событий после отмены подписки обработчика, если событие получено одновременно с запросом на отмену подписки на событие. Рекомендуется следовать стандарту COM и избегать уничтожения объекта обработчика событий до тех пор, пока его количество ссылок не достигнет нуля. Удаление обработчика событий сразу после отмены подписки на события может привести к нарушению доступа, если событие доставляется с опозданием.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и Обновление платформы для Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	uiautomationclient.h (включая UIAutomation.h)