配列データの列方向バインディング
結果セットを配列に取り出す場合、SQLBindCol() を呼び出して、アプリケーション変数を結果セット内の列にバインドできます。この関数を呼び出す前に、SQLSetStmtAttr() を呼び出して、取り出す行数を設定する必要があります。
次の図は、列方向バインドの論理ビューです。

- SQLSetStmtAttr() を呼び出して、行セット・サイズを設定します。
SQLExtendedFetch() を使用して行をフェッチする計画ならば、SQL_ATTR_ROWSET_SIZE 属性設定を各フェッチで取り出す行数に設定します。
SQLFetchScroll() を使用して行をフェッチする計画ならば、SQL_ATTR_ROW_ARRAY_SIZE 属性設定を各フェッチで取り出す行数に設定します。
ステートメント・ハンドル上で SQL_ATTR_ROWSET_SIZE または SQL_ATTR_ROW_ARRAY_SIZE 属性値が 1 より大きい場合 は、Db2® ODBC は据え置き出力データ・ポインターおよびそのハンドルの長さポインターを 配列へのポインターとして扱います。
- 結果セットの各列ごとに SQLBindCol() を呼び出します。
この呼び出しで、以下の引数値を組み込みます。
- 引数 rgbValue が、引数 icol で指定した列からのデータを受け取る配列を 指すようにします。
- 文字入力データおよびバイナリー入力データの場合、入力引数 cbValueMax を用いて、 配列のエレメントの最大サイズを指定します。(その他の入力データ・タイプの場合は、この引数は 無視されます。)
- オプションとして、列データを受け取る配列でそれぞれの完全な値が必要とするバイト数 を取り出すことができます。 長さデータを取り出すには、それぞれの取り出される値ごとに Db2 ODBC が戻すバイト数を入れる予定の 配列に向けて、この引数 pcbValue が指すようにします。長さデータを取り出さない場合は、この引数値は NULL に設定する必要があります。
- SQLExtendedFetch() または SQLFetchScroll() を呼び出して、結果データを取り出して配列に入れます。
SQLExtendedFetch() 呼び出しの場合、結果セット内の行数が SQL_ATTR_ROWSET_SIZE 属性値よりも大きいならば、SQLExtendedFetch() を複数回呼び出してすべての行を取り出す必要があります。
SQLExtendedScroll() 呼び出しの場合、結果セット内の行数が SQL_ATTR_ARRAY_SIZE 属性値よりも大きいならば、SQLFetchScroll() を複数回呼び出して、すべての行を取り出す必要があります。
Db2 ODBC は、最大バッファー・サイズ値を引数として使用して、結果として取り出された連続する各値の 配列内の保管場所を判断します。この値は、SQLBindCol() の引数 cbValueMax で指定します。 Db2 ODBC はオプションとして、各エレメントが持つバイト数を据え置き長さ配列の中に保管します。この据え置き配列は、SQLBindCol() の引数 pcbValue で指定します。