UiaReturnRawElementProvider 함수(uiautomationcoreapi.h)

창에 대한 UI 자동화 공급자에 대한 인터페이스를 가져옵니다.

구문

LRESULT UiaReturnRawElementProvider(
  [in] HWND                      hwnd,
  [in] WPARAM                    wParam,
  [in] LPARAM                    lParam,
  [in] IRawElementProviderSimple *el
);

매개 변수

[in] hwnd

형식: HWND

공급자가 제공하는 요소를 포함하는 창의 핸들입니다.

[in] wParam

형식: WPARAM

WM_GETOBJECT 메시지의 wParam 인수입니다.

[in] lParam

형식: LPARAM

WM_GETOBJECT 메시지의 lParam 인수입니다.

[in] el

형식: IRawElementProviderSimple*

UI 자동화 공급자입니다.

반환 값

형식: LRESULT

UI 자동화 통해 서버 프로세스에 연결하는 클라이언트 프로세스의 키입니다.

이 함수는 공급자 발생 이벤트 맵을 제거하는 것이 안전하다는 것을 UI 자동화 알리는 데 사용될 때 0을 반환합니다. 자세한 내용은 설명 부분을 참조하세요.

설명

이 함수는 컨트롤에 대한 UI 자동화 공급자와 UI 자동화 제공하기 위해 WM_GETOBJECT 메시지를 받을 때 컨트롤에 의해 호출됩니다. 필터링하면 Microsoft Active Accessibility 클라이언트에 문제가 발생할 수 있으므로 컨트롤은 wParam 및 lParam 매개 변수를 먼저 필터링하지 않고 UiaReturnRawElementProvider 함수에 전달해야 합니다. 컨트롤의 창 프로시저는 UiaReturnRawElementProvider를 호출한 결과를 반환해야 합니다.

Microsoft Active Accessibility 클라이언트가 UI 자동화 공급자가 발생시킨 이벤트를 수신 대기하는 경우 UI 자동화 이벤트를 발생시킨 공급자의 맵을 유지 관리합니다. Microsoft Active Accessibility 클라이언트가 추가 정보를 요청하면 UI 자동화 맵을 사용하여 요청을 적절한 공급자에게 라우팅합니다. 이전에 공급자를 반환한 창이 제거된 경우 다음과 UiaReturnRawElementProvider(hwnd, 0, 0, NULL)같이 UiaReturnRawElementProvider 함수를 호출하여 UI 자동화 알려야 합니다. 이 호출은 지정된 창을 참조하는 모든 맵 항목을 안전하게 제거할 수 있음을 UI 자동화 알려줍니다. 이 호출은 발생된 이벤트 맵에 의해 유지되는 공급자에 대한 참조를 해제하기 때문에 메모리를 저장할 수 있습니다. 함수는 이러한 특수 매개 변수를 사용하여 호출할 때 0을 반환합니다. UI 자동화 공급자를 반환하는 창의 WM_DESTROY 메시지 처리기에서 이 호출을 수행하는 것이 좋습니다.

요구 사항

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