IRawElementProviderAdviseEvents::AdviseEventAdded 메서드(uiautomationcore.h)

UI 자동화 클라이언트가 속성 변경 이벤트를 포함하여 특정 이벤트를 수신 대기하기 시작하면 Microsoft UI 자동화 공급자에게 알 수 있습니다.

구문

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

매개 변수

[in] eventId

형식: EVENTID

추가되는 이벤트의 식별자입니다. 이벤트 ID 목록은 이벤트 식별자를 참조하세요.

[in] propertyIDs

형식: SAFEARRAY*

추가되는 속성의 식별자에 대한 포인터이거나, 추가되는 이벤트 수신기가 속성 이벤트를 수신 대기하지 않는 경우 NULL 입니다.

반환 값

형식: HRESULT

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

설명

이 메서드를 사용하면 수신 대기 중인 이벤트만 발생시켜 공급자가 오버헤드를 줄일 수 있습니다.

UI 자동화 공급자는 IUnknown 인터페이스의 AddRef 메서드처럼 IRawElementProviderAdviseEvents::AdviseEventAdded를 처리하는 것이 중요합니다. AdviseEventAdded가 특정 이벤트 또는 속성에 대해 AdviseEventRemoved보다 더 많이 호출된 한 공급자는 일부 클라이언트가 여전히 수신 대기 중이므로 해당 이벤트를 계속 발생시켜야 합니다. 또는 UI 자동화 공급자는 UiaClientsAreListening 함수를 사용하여 하나 이상의 클라이언트가 수신 대기하고 있는지 확인하고, 이 경우 모든 적절한 이벤트를 발생할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	uiautomationcore.h(UIAutomation.h 포함)

추가 정보

안전한 배열 사용에 대한 모범 사례

개념

IRawElementProviderAdviseEvents

참조