IADsExtension::P rivateInvoke メソッド (iads.h)

[アーティクル]
02/28/2024

IADsExtension::P rivateInvoke メソッドは、通常、IADsExtension::P rivateGetIDsOfNames メソッドの後に ADSI によって呼び出されます。このメソッドは、カスタム実装を使用することも、操作を IDispatch::D ispInvoke メソッドに委任することもできます。

構文

HRESULT PrivateInvoke(
  [in]  DISPID       dispidMember,
  [in]  REFIID       riid,
  [in]  LCID         lcid,
  [in]  WORD         wFlags,
  [in]  DISPPARAMS   *pdispparams,
  [out] VARIANT      *pvarResult,
  [out] EXCEPINFO    *pexcepinfo,
  [out] unsigned int *puArgErr
);

パラメーター

[in] dispidMember

メンバーを識別します。ディスパッチ識別子を取得するには、 IADsExtension::P rivateGetIDsOfNames メソッドを使用します。

[in] riid

将来使用するために予約されています。 IID_NULL にする必要があります。

[in] lcid

引数を解釈する対象のロケールコンテキスト。 IADsExtension::P rivateGetIDsOfNames 関数は lcid を使用します。また、 PrivateInvoke メソッドに渡して、ロケールに固有の引数をオブジェクトが解釈できるようにします。

[in] wFlags

PrivateInvoke 呼び出しのコンテキストを記述するフラグには、が含まれます。

DISPATCH_METHOD

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

DISPATCH_PROPERTYGET

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

DISPATCH_PROPERTYPUT

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

DISPATCH_PROPERTYPUTREF

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

[in] pdispparams

引数の配列、名前付き引数の引数 DISPID の配列、配列内の要素の数を受け取る DISPPARAMS 構造体へのポインター。

[out] pvarResult

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

[out] pexcepinfo

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

[out] puArgErr

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

戻り値

このメソッドは、標準の戻り値と、次の値をサポートします。

その他の戻り値の詳細については、「 ADSI エラーコード」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	iads.h
[DLL]	Activeds.dll