CCmdTarget::GetIDispatch

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

IDispatch ポインタまたは参照による IDispatch ポインタを返すオートメーションメソッドから IDispatch ポインタを受け取ります。

LPDISPATCH GetIDispatch(
   BOOL bAddRef 
);

パラメータ

bAddRef
オブジェクトの参照カウントを増加するかどうかを指定します。

戻り値

オブジェクトに関連付けられた IDispatch ポインタを返します。

解説

コンストラクタで EnableAutomation が呼び出されて、オートメーションが許可されたオブジェクトでは、IDispatch インターフェイスを使って会話するクライアントが使う IDispatch の Foundation Class の実装へのポインタを返します。この関数の呼び出しにより、自動的にポインタに参照が追加されるため、IUnknown::AddRef を呼び出す必要はありません。