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 |
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기