Метод IUIAutomation::RemoveAutomationEventHandler (uiautomationclient.h)
Удаляет указанный обработчик событий модель автоматизации пользовательского интерфейса.
Синтаксис
HRESULT RemoveAutomationEventHandler(
[in] EVENTID eventId,
[in] IUIAutomationElement *element,
[in] IUIAutomationEventHandler *handler
);
Параметры
[in] eventId
Тип: EVENTID
Идентификатор обрабатываемого события. Список идентификаторов событий см. в разделе Идентификаторы событий.
[in] element
Тип: IUIAutomationElement*
Указатель на элемент модель автоматизации пользовательского интерфейса, обрабатывающий событие.
[in] handler
Тип: IUIAutomationEventHandler*
Указатель на метод обработчика, переданный в IUIAutomation::AddAutomationEventHandler для указанного идентификатора события и элемента модель автоматизации пользовательского интерфейса.
Возвращаемое значение
Тип: 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) |
См. также раздел
RemoveFocusChangedEventHandler