結果の処理 (Native Client OLE DB プロバイダー)

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

コマンドの実行、またはプロバイダーからの行セット オブジェクトの直接生成のいずれかによって行セット オブジェクトを作成する場合、コンシューマーはその行セット内のデータにアクセスして、データを取得する必要があります。

行セットは、SQL Server Native Client OLE DB プロバイダーが表形式でデータを公開できるようにする中心的なオブジェクトです。 概念的には、行セットは行の集まりを表し、各行には列データが格納されています。 行セット オブジェクトでは、IRowset (行セットから順番に行をフェッチするメソッドを含みます)、IAccessor (コンシューマーのプログラム変数に表形式のデータをバインドする方法を指定する一連の列バインドの定義を許可します)、IColumnsInfo (行セット内の列に関する情報を提供します)、IRowsetInfo (行セットに関する情報を提供します) などのインターフェイスが公開されます。

コンシューマーは、IRowset::GetData メソッドを呼び出して、データ行を行セットからバッファーに取得できます。 GetData を呼び出す前に、DBBINDING 構造体のセットを使用してバッファーを記述します。 各バインドは、行セット内の列をコンシューマーのバッファーに格納する方法を記述するもので、次の情報が含まれます。

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

• バインドされる内容 (データ値、データの長さ、バインドの状態など) に関する情報

• バッファー内の各部分へのオフセットに関する情報

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

プロバイダーはデータを取得するときに、各バインドの情報を使用してコンシューマーのバッファーからデータを取得する位置と方法を決定します。 また、コンシューマーのバッファーにデータを設定するときに、各バインドの情報を使用してコンシューマーのバッファー内にあるデータを返す位置と方法を決定します。

DBBINDING 構造体を指定したら、アクセサーを作成 (IAccessor::CreateAccessor) します。 バインドの集まりであるアクセサーは、コンシューマーのバッファー内のデータを取得または設定するときに使用します。

参照

SQL Server Native Client OLE DB プロバイダー アプリケーションの作成
OLE DB の使用法に関するトピック