다음을 통해 공유

IUIAutomation6::AddEventHandlerGroup 메서드(uiautomationclient.h)

  • 아티클

IUIAutomation6::CreateEventHandlerGroup에 지정된 이벤트 처리기 메서드의 컬렉션을 등록합니다.

중요

Microsoft UI 자동화 클라이언트는 처리기 그룹 메서드를 사용하여 다양한 IUIAutomation 인터페이스 네임스페이스에 정의된 개별 이벤트 등록 방법 대신 이벤트 수신기를 등록해야 합니다.

구문

HRESULT AddEventHandlerGroup(
  [in] IUIAutomationElement           *element,
       IUIAutomationEventHandlerGroup *handlerGroup
);

매개 변수

[in] element

이벤트 처리기 그룹과 연결된 UI 자동화 요소에 대한 포인터입니다.

handlerGroup

UI 자동화 이벤트 수신기의 컬렉션입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이벤트 처리기를 구현하기 전에 스레딩 문제 이해에 설명된 스레딩 문제를 잘 알고 있어야 합니다.

이벤트 구독 취소 요청과 함께 이벤트가 동시에 수신되는 경우 처리기를 구독 취소한 후 이벤트 처리기에 이벤트가 전달될 수 있습니다. COM(구성 요소 개체 모델) 표준을 따르고 참조 수가 0에 도달할 때까지 이벤트 처리기 개체가 삭제되지 않도록 하는 것이 가장 좋습니다. 이벤트 구독을 취소한 직후 이벤트 처리기를 삭제하면 이벤트가 늦게 배달되는 경우 액세스 위반이 발생할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10, 버전 1809[데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 버전 1709 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 uiautomationclient.h(UIAutomation.h 포함)

추가 정보

IUIAutomation6::RemoveEventHandlerGroup, IUIAutomation6 인터페이스