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); 
} 

要件

関連項目

プロバイダーの関数