IAxWinAmbientDispatchEx インターフェイス

[アーティクル]
04/03/2023

このインターフェイスは、ホストされるコントロールの補助アンビエントプロパティを実装します。

重要

このクラスとそのメンバーは、Windows ランタイムで実行するアプリケーションで使用することはできません。

構文

MIDL_INTERFACE("B2D0778B - AC99 - 4c58 - A5C8 - E7724E5316B5") IAxWinAmbientDispatchEx : public IAxWinAmbientDispatch

メンバー

メソッド

Name	説明
SetAmbientDispatch	このメソッドは、ユーザー定義のインターフェイスを使用して、既定のアンビエントプロパティインターフェイスを補うために呼び出されます。

解説

このインターフェイスは、ATL に静的にリンクされ、ActiveX コントロール (特にアンビエントプロパティを持つコントロール) をホストする ATL アプリケーションに組み込みます。このインターフェイスを組み込まないと、次のアサーションが生成されます: "LIBID を CComModule::Init に渡し忘れましたか"

このインターフェイスは、ATL の ActiveX コントロールのホスティングオブジェクトによって公開されます。 IAxWinAmbientDispatch から派生した IAxWinAmbientDispatchEx によって追加されるメソッドを使用すると、ATL によって提供されるアンビエントプロパティインターフェイスを独自のもので補完することができます。

AxHost は、コードを含むタイプライブラリから IAxWinAmbientDispatch と IAxWinAmbientDispatchEx に関する型情報を読み込もうとします。

ATL90.dll にリンクしている場合、AXHost は、DLL 内のタイプライブラリから型情報を読み込みます。

詳細については、「ATL AXHost を使用して ActiveX コントロールをホストする」を参照してください。

必要条件

このインターフェイスの定義は、次の表に示すように、多くの形式で使用できます。

定義の種類	ファイル
IDL	atliface.idl
タイプライブラリ	ATL.dll
C++	atliface.h (ATLBase.h にも含まれる)

IAxWinAmbientDispatchEx::SetAmbientDispatch

このメソッドは、ユーザー定義のインターフェイスを使用して、既定のアンビエントプロパティインターフェイスを補うために呼び出されます。

virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;

パラメーター

pDispatch
新しいインターフェイスへのポインター。

戻り値

成功した場合は S_OK、失敗した場合はエラー HRESULT を返します。

解説

新しいインターフェイスへのポインターを使用して SetAmbientDispatch が呼び出されると、ホストされたコントロールから要求されるプロパティまたはメソッドを呼び出すために、この新しいインターフェイスが使用されます (それらのプロパティがまだ IAxWinAmbientDispatch により提供されていない場合)。