次の方法で共有

独自のカスタム ハンドラーの記述

  • [アーティクル]

既定の RDS サポートを必要とする IIS サーバー管理者が、ユーザー要求とアクセス権をより詳細に制御する場合は、独自のハンドラーを作成できます。

MSDFMAP.Handler は IDataFactoryHandler インターフェイスを実装します。

重要

Windows 8 および Windows Server 2012 から、RDS サーバー コンポーネントが Windows オペレーティング システムに含まれなくなりました (詳細については、Windows 8 および Windows Server 2012 の互換性クックブックを参照してください)。 RDS クライアント コンポーネントは、今後のバージョンの Windows で削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 RDS を使用するアプリケーションを WCF Data Service に移行する必要があります。

IDataFactoryHandler インターフェイス

このインターフェイスには、GetRecordset と Reconnect の 2 つのメソッドがあります。 どちらのメソッドでも、CursorLocation プロパティを adUseClient に設定する必要があります。

どちらのメソッドも、"Handler=" キーワードの最初のコンマの後に表示される引数を受け取ります。 たとえば、"Handler=progid,arg1,arg2;" は、"arg1,arg2" という引数文字列を渡し、"Handler=progid" は null 引数を渡します。

GetRecordset メソッド

このメソッドは、データ ソースのクエリを実行し、指定された引数を使用して新しい Recordset オブジェクトを作成します。 Recordset は adLockBatchOptimistic で開く必要があり、非同期で開く必要はありません。

引数

conn 接続文字列。

args ハンドラーの引数。

query クエリを作成するためのコマンド テキスト。

ppRSRecordset を返すポインター。

Reconnect メソッド

このメソッドは、データ ソースを更新します。 新しい Connection オブジェクトを作成し、指定された Recordset をアタッチします。

引数

conn 接続文字列。

args ハンドラーの引数。

pRSRecordset オブジェクト。

msdfhdl.idl

これは、msdfhdl.idl ファイルに表示される IDataFactoryHandler のインターフェイス定義です。

[  
  uuid(D80DE8B3-0001-11d1-91E6-00C04FBBBFB3),  
  version(1.0)  
]  
library MSDFHDL  
{  
    importlib("stdole32.tlb");  
    importlib("stdole2.tlb");  
  
    // TLib : Microsoft ActiveX Data Objects 2.0 Library  
    // {00000200-0000-0010-8000-00AA006D2EA4}  
    #ifdef IMPLIB  
    importlib("implib\\x86\\release\\ado\\msado15.dll");  
    #else  
    importlib("msado20.dll");  
    #endif  
  
    [  
      odl,  
      uuid(D80DE8B5-0001-11d1-91E6-00C04FBBBFB3),  
      version(1.0)  
    ]  
    interface IDataFactoryHandler : IUnknown  
    {  
HRESULT _stdcall GetRecordset(  
      [in] BSTR conn,  
      [in] BSTR args,  
      [in] BSTR query,  
      [out, retval] _Recordset **ppRS);  
  
// DataFactory will use the ActiveConnection property  
// on the Recordset after calling Reconnect.  
   HRESULT _stdcall Reconnect(  
      [in] BSTR conn,  
      [in] BSTR args,  
      [in] _Recordset *pRS);  
    };  
};

参照

カスタマイズ ファイルの Connect セクション
カスタマイズ ファイルの Logs セクション
カスタマイズ ファイルの SQL セクション
カスタマイズ ファイルの UserList セクション
DataFactory のカスタマイズ
必要なクライアントの設定
カスタマイズ ファイルの概要