次の方法で共有

IADsExtension インターフェイス (iads.h)

  • [アーティクル]

IADsExtension インターフェイスは、ADSI アプリケーション拡張モデルの基礎を形成します。 これにより、独立系ソフトウェア ベンダー (ISV) は、メソッドや関数などのアプリケーション固有の動作を既存の ADSI オブジェクトに追加できます。 複数のベンダーは、同じオブジェクトの機能を個別に拡張して、類似した、しかし関連性のない操作を実行できます。

拡張機能モデルは、COM の集計モデルに基づいています。 アグリゲーター (外部オブジェクト) は、メソッドのベース、集計オブジェクト、または内部オブジェクトにを追加できます。 IADsExtension インターフェイスを実装する ADSI 拡張オブジェクトは集計オブジェクトですが、ADSI プロバイダーはアグリゲーターです。

メモ 拡張モジュールを実装する場合は、インターフェイスの使用が完了したら、インターフェイスを解放します。 それ以外の場合、アグリゲーターは不要になった場合でもインターフェイスを解放できません。
 
IADsExtension インターフェイスは、次のように使用できます。
  • 拡張機能コンポーネントには、Operate メソッドの dwCode で定義されている初期化通知が必要です。 この場合、拡張クライアントは Operate メソッドを呼び出す必要があります。 他の 2 つのメソッド (PrivateInvoke と PrivateGetIDsOfNames) は、通常、HRESULT 値でE_NOTIMPLを返します。
  • 拡張コンポーネントは、デュアル インターフェイスまたはディスパッチ インターフェイスをサポートします。 この場合、拡張クライアントは PrivateGetIDsOfNames または PrivateInvoke メソッドを呼び出す必要があります。 通常、操作はデータを無視し、HRESULT 値のE_NOTIMPLを返します。

継承

IADsExtension インターフェイスは、IUnknown インターフェイスから継承されます。 IADsExtension には、次の種類のメンバーもあります。

メソッド

IADsExtension インターフェイスには、これらのメソッドがあります。

 
IADsExtension::Operate

プロバイダーの仕様に従って、制御コードと入力パラメーターを解釈します。
IADsExtension::P rivateGetIDsOfNames

IADsExtension::P rivateGetIDsOfNames メソッドは、ADSI が拡張を使用してデュアル インターフェイスまたはディスパッチ インターフェイスをサポートしていると判断した後、アグリゲーター ADSI によって呼び出されます。 メソッドは、型データを使用して、IDispatch::GetIDsOfNames を使用して DISPID を取得できます。
IADsExtension::P rivateInvoke

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

要件

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