IExpDispSupport::OnInvoke メソッド (shdeprecated.h)

非推奨になりました。 アンビエント プロパティを取得します。

構文

HRESULT OnInvoke(
  [in] DISPID     dispidMember,
  [in] REFIID     iid,
  [in] LCID       lcid,
  [in] WORD       wFlags,
       DISPPARAMS *pdispparams,
       VARIANT    *pVarResult,
       EXCEPINFO  *pexcepinfo,
       UINT       *puArgErr
);

パラメーター

[in] dispidMember

種類: DISPID

呼び出されるメンバーを識別するディスパッチ ID。

[in] iid

種類: REFIID

予約済み。 IID_NULL にする必要があります。

[in] lcid

種類: LCID

引数を解釈するロケール コンテキストを提供するロケール ID。 複数の言語をサポートしていないアプリケーションでは、このパラメーターを無視できます。

[in] wFlags

種類: WORD

次を含む、呼び出しのコンテキストを記述するフラグ。

DISPATCH_METHOD

メンバーはメソッドとして呼び出されます。 プロパティの名前が同じ場合は、this フラグと DISPATCH_PROPERTYGET フラグの両方を設定できます。 メンバーはメソッドとして呼び出されます。 プロパティの名前が同じ場合は、this フラグと DISPATCH_PROPERTYGET フラグの両方を設定できます。

DISPATCH_PROPERTYGET

メンバーは、プロパティまたはデータ メンバーとして取得されます。

DISPATCH_PROPERTYPUT

メンバーは、プロパティまたはデータ メンバーとして変更されます。

DISPATCH_PROPERTYPUTREF

メンバーは、値の割り当てではなく、参照割り当てによって変更されます。 このフラグは、 プロパティがオブジェクトへの参照を受け入れる場合にのみ有効です。

pdispparams

種類: DISPPARAMS*

引数の配列、名前付き引数の引数 DISPID の配列、および配列内の要素の数を含む DISPPARAMS 構造体へのポインター。

pVarResult

型: VARIANT*

結果が格納される場所へのポインター。呼び出し元が結果を予期しない場合は NULL 。 DISPATCH_PROPERTYPUTまたはDISPATCH_PROPERTYPUTREFが指定されている場合、この引数は無視されます。

pexcepinfo

種類: EXCEPINFO*

例外情報を格納する構造体へのポインター。 DISP_E_EXCEPTIONが返される場合は、この構造体を入力する必要があります。 NULL を指定できます。

puArgErr

種類: UINT*

エラーが発生した最初の引数の DISPPARAMS 構造体の rgvarg メンバー内のインデックス。 引数は逆の順序で rgvarg に格納されるため、最初の引数は配列内でインデックスが最も高いものになります。 このパラメーターは、結果の戻り値がDISP_E_TYPEMISMATCHまたはDISP_E_PARAMNOTFOUND場合にのみ返されます。 この引数は NULL に設定できます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

詳細については、「 IDispatch::Invoke」を参照してください。

要件