CWnd::InvokeHelper

[アーティクル]
08/09/2011

dwDispID によって指定された ActiveX コントロールメソッドまたはプロパティを wFlags で指定されたコンテキストで呼び出すには、このメンバー関数を呼び出します。

void AFX_CDECL InvokeHelper(
   DISPID dwDispID,
   WORD wFlags,
   VARTYPE vtRet,
   void* pvRet,
   const BYTE* pbParamInfo,
   ... 
);

パラメーター

dwDispID
呼び出されるメソッドまたはプロパティを識別します。
wFlags
IDispatch::Invoke の呼び出しのコンテキストを示すフラグ。
vtRet
戻り値の型。指定できる値については、COleDispatchDriver::InvokeHelper の「解説」を参照してください。
pvRet
プロパティの値または戻り値を受ける変数のアドレスを指定します。この変数の型は、vtRet で指定された型と一致している必要があります。
pbParamInfo
pbParamInfo に続くパラメーターの型を指定するバイト列の NULL で終わる文字列へのポインター。指定できる値については、COleDispatchDriver::InvokeHelper の「解説」を参照してください。
...
pbParamInfo で指定した型の可変数のパラメーターリストを指定してください。

解説

パラメーター pbParamInfo には、メソッドまたはプロパティに渡されるパラメーターの型を指定します。引数リストは構文の ... で表されます。

この関数はパラメーターを VARIANTARG 値に変換し、ActiveX コントロールの IDispatch::Invoke メソッドを適用します。 IDispatch::Invoke の呼び出しが失敗した場合は、例外をスローします。 IDispatch::Invoke により返された SCODE (ステータスコード) が DISP_E_EXCEPTION の場合は、COleException オブジェクトをスローします。それ以外は、COleDispatchException をスローします。

注意

この関数は、ActiveX コントロールを表す CWnd オブジェクト上でのみ呼び出される必要があります。

ActiveX コントロールコンテナーを伴ったこのメンバー関数を使用しての詳細については、資料を参照してくださいActiveX コントロールコンテナー:ActiveX コントロールコンテナーでの ActiveX コントロールのプログラミング。