ストアド プロシージャの呼び出し (OLE DB)

ストアド プロシージャは、0 個以上のパラメーターを受け取ることができます。また、値を返すこともできます。SQL Server Native Client OLE DB プロバイダーを使用しているときは、ストアド プロシージャのパラメーターを次の方法で渡すことができます。

• データ値をハードコーディングする。

• パラメーター マーカー (?) を使用してパラメーターを指定し、プログラム変数をパラメーター マーカーにバインドしてから、データ値をプログラム変数に格納する。

注
OLE DB で名前付きパラメーターを使用して SQL Server ストアド プロシージャを呼び出す場合は、パラメーター名の先頭に '@' 文字を付ける必要があります。これは、SQL Server 固有の制限です。SQL Server Native Client OLE DB プロバイダーは、この制限を MDAC よりも厳密に適用します。

パラメーターをサポートするには、コマンド オブジェクトで ICommandWithParameters インターフェイスを公開します。パラメーターを使用するには、コンシューマーは、まず ICommandWithParameters::SetParameterInfo メソッドを呼び出して、プロバイダーに渡すパラメーターを記述します (または、必要に応じて、GetParameterInfo メソッドを呼び出す呼び出し元ステートメントを準備します)。次に、バッファーの構造を指定するアクセサーを作成し、このバッファーにパラメーター値を格納します。最後に、アクセサーのハンドルとバッファーへのポインターを Execute に渡します。その後 Execute を呼び出す場合は、バッファーに新しいパラメーター値を格納し、アクセサー ハンドルとバッファー ポインターを指定して Execute を呼び出します。

パラメーターを使用する一時ストアド プロシージャを呼び出すコマンドは、まず、ICommandWithParameters::SetParameterInfo を呼び出してパラメーター情報を定義しないと、コマンドは適切に準備されません。これは、一時ストアド プロシージャの内部名がクライアントで使用される外部名とは異なるので、SQLOLEDB がシステム テーブルをクエリして、一時ストアド プロシージャのパラメーター情報を判断できないためです。

次に、パラメーターのバインド プロセスの手順を示します。

1. DBPARAMBINDINFO 構造体の配列にパラメーター情報を格納します。パラメーター情報には、パラメーター名、パラメーターのデータ型を表すプロバイダー固有の名前、標準のデータ型名などが含まれます。配列内の構造体 1 つが、1 つのパラメーターを表します。この配列に情報を格納して、SetParameterInfo メソッドに渡します。

2. ICommandWithParameters::SetParameterInfo メソッドを呼び出し、パラメーターをプロバイダーに示します。SetParameterInfo は、各パラメーターのネイティブ データ型を指定します。SetParameterInfo 引数は次のとおりです。

   • 型情報を設定するパラメーターの数

   • 型情報を設定するパラメーターの序数の配列

   • DBPARAMBINDINFO 構造体の配列

3. IAccessor::CreateAccessor コマンドを使用してパラメーター アクセサーを作成します。このアクセサーにより、バッファーの構造を指定し、パラメーター値をバッファーに格納します。CreateAccessor コマンドは、バインドのセットからアクセサーを作成します。このバインドは、コンシューマーが DBBINDING 構造体の配列を使用して記述します。各バインドでは、1 つのパラメーターをコンシューマーのバッファーに関連付けます。バインドには、次のような情報が含まれます。

   • バインドが適用されるパラメーターの序数

   • バインドの対象 (データ値、データ値の長さと状態)

   • これらの各情報に関するバッファー内のオフセット

   • コンシューマーのバッファー内にあるデータ値の長さと型

   アクセサーは、アクセサーのハンドルにより識別されます。このハンドルは HACCESSOR 型です。このハンドルは、CreateAccessor メソッドから返されます。コンシューマーはアクセサーを使い終わるたびに、ReleaseAccessor メソッドを呼び出してアクセサーが保持しているメモリを解放する必要があります。

   コンシューマーが ICommand::Execute などのメソッドを呼び出す場合、アクセサーのハンドルとバッファー自体へのポインターを渡します。プロバイダーはこのアクセサーを使用して、バッファー内にあるデータを送信する方法を決定します。

4. DBPARAMS 構造体にデータを格納します。入力パラメーター値の取得と出力パラメーター値の書き込みに使われるコンシューマーの変数が、実行時に DBPARAMS 構造体の ICommand::Execute に渡されます。DBPARAMS 構造体には、次の 3 つの要素が含まれます。

   • アクセサー ハンドルで指定されているバインドに従ってプロバイダーが入力パラメーター データを取得し、出力パラメーター データを返すための、バッファーへのポインター

   • バッファー内のパラメーター セットの数

   • 手順 3. で作成したアクセサー ハンドル

5. ICommand::Execute を使用してコマンドを実行します。