UiaAddEvent 함수(uiautomationcoreapi.h)

참고 이 함수는 더 이상 사용되지 않습니다. 클라이언트 애플리케이션은 MICROSOFT UI 자동화 COM(구성 요소 개체 모델) 인터페이스를 대신 사용해야 합니다.

 

UI 자동화 트리의 노드에서 이벤트에 대한 수신기를 추가합니다.

구문

HRESULT UiaAddEvent(
  [in]  HUIANODE         hnode,
  [in]  EVENTID          eventId,
  [in]  UiaEventCallback *pCallback,
  [in]  TreeScope        scope,
  [in]  PROPERTYID       *pProperties,
  [in]  int              cProperties,
  [in]  UiaCacheRequest  *pRequest,
  [out] HUIAEVENT        *phEvent
);

매개 변수

[in] hnode

형식: HUIANODE

이벤트 수신기를 추가할 노드입니다.

[in] eventId

형식: EVENTID

수신 대기할 이벤트의 식별자입니다. 이벤트 ID 목록은 이벤트 식별자를 참조하세요.

[in] pCallback

형식: UiaEventCallback*

이벤트가 발생할 때 호출되는 애플리케이션 정의 UiaEventCallback 콜백 함수의 주소입니다.

[in] scope

형식: TreeScope*

처리할 이벤트의 scope 나타내는 TreeScope 열거형 형식의 값입니다. 즉, 요소 자체에 있는지 또는 상위 항목과 자식에 있는지 여부입니다.

[in] pProperties

형식: PROPERTYID*

eventId가 AutomationPropertyChanged_Event_GUID 파생된 EVENTID 인 경우 변경 이벤트를 모니터링할 속성의 식별자를 포함하는 배열의 주소입니다. 그렇지 않으면 이 매개 변수가 NULL입니다. 속성 ID 목록은 속성 식별자를 참조하세요.

[in] cProperties

형식: int

pProperties 배열의 요소 수입니다.

[in] pRequest

형식: UiaCacheRequest*

이벤트와 함께 반환되는 노드에 대해 적용되는 캐시 요청을 정의하는 UiaCacheRequest 구조체의 주소입니다.

[out] phEvent

형식: HUIEVENT*

이 함수가 반환되면 가 추가되는 이벤트에 대한 포인터를 포함합니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uiautomationcoreapi.h
라이브러리	Uiautomationcore.lib
DLL	Uiautomationcore.dll

추가 정보

UiaLookupId