다음을 통해 공유

UiaHostProviderFromHwnd 함수(uiautomationcoreapi.h)

  • 아티클

창에 대한 호스트 공급자를 가져옵니다.

구문

HRESULT UiaHostProviderFromHwnd(
  [in]  HWND                      hwnd,
  [out] IRawElementProviderSimple **ppProvider
);

매개 변수

[in] hwnd

형식: HWND

공급자가 제공하는 요소가 들어 있는 창입니다.

[out] ppProvider

형식: IRawElementProviderSimple**

창의 호스트 공급자입니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수에서 검색한 개체는 IRawElementProviderSimple::get_HostRawElementProvider 메서드 호출에 응답하는 데만 유용합니다. 개체를 사용하여 이벤트를 발생시키고, 속성을 제공하는 등의 작업을 수행할 수 없습니다. 이벤트를 발생하거나 속성을 제공해야 하는 경우 IRawElementProviderSimple 인터페이스를 완전히 구현하는 공급자 개체를 만들어야 합니다.

예제

다음 예제에서는 이 공급자가 제공하는 컨트롤을 호스트하는 창에 대한 호스트 공급자를 반환합니다.

HRESULT STDMETHODCALLTYPE Provider::get_HostRawElementProvider(IRawElementProviderSimple** pRetVal)
{
    return UiaHostProviderFromHwnd(controlHWnd, pRetVal); 
}

요구 사항

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

추가 정보

공급자에 대한 함수