IADsExtension

IADsExtension インターフェイスは、ADSI アプリケーション拡張モデルの基礎を成します。

プロバイダーの仕様に従って、コントロールコードと入力パラメーターを解釈します。

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

その他の戻り値の詳細については、ADSI Error Codes を参照してください。

アグリゲーターは E_FAIL および E_NOTIMPL の戻り値を無視します。

例

次の C/C++ コード例は、一般的な実装を示しています。

STDMETHOD(Operate)(ULONG dwCode, VARIANT varData1, VARIANT varData2, VARIANT varData3)
{
   HRESULT hr = S_OK;
   switch (dwCode) 
   {
      case ADS_EXT_INITCREDENTIALS:
      // Prompt for a credential.
      // MessageBox(NULL, "INITCRED", "ADsExt", MB_OK);

      break;
      default:
          hr = E_FAIL;
      break;
    }        
    return hr;
}

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

戻り値は、標準の IDispatch::GetIDsOfNames メソッドと同じです。その他の戻り値の詳細については、ADSI Error Codes を参照してください。

すべてのパラメーターは、標準の IDispatch::GetIDsOfNames() の対応するパラメーターと同じ意味を持ちます。拡張コンポーネントは、サポートされるデュアルインターフェイスで定義された各メソッドまたはプロパティに対して、一意の識別子 (rgDispID) を返します。一意性は拡張コンポーネント内で保証されます。ADSI プロバイダーは、すべての拡張オブジェクトおよびアグリゲーター (ADSI) 自体の DISPID の一意性を保証する必要があります。rgDispID パラメーターは 1 から 16777215 (2^24-1) の範囲、または -1 (DISPID_UNKNOWN) である必要があります。

例

次の C/C++ コード例は、このメソッドの一般的な実装を示しています。

STDMETHOD(PrivateGetIDsOfNames)(REFIID riid, OLECHAR ** rgszNames, unsigned int cNames, LCID lcid, DISPID  * rgdispid)
{
  if (rgdispid == NULL)
  {
     return E_POINTER;
  }
  return  DispGetIDsOfNames(m_pTypeInfo, rgszNames, cNames, rgdispid);
}

IADsExtension::PrivateInvoke メソッドは、通常、IADsExtension::PrivateGetIDsOfNames メソッドの後に ADSI によって呼び出されます。このメソッドは、独自の実装を持つことも、操作を IDispatch::DispInvoke メソッドに委譲することもできます。

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

その他の戻り値の詳細については、ADSI Error Codes を参照してください。