ドライバーの機能

[アーティクル]
05/23/2023

次の表は、ODBC 3.x ドライバーがブロックおよびスクロール可能カーソルに実装する必要がある関数とステートメント属性をまとめたものです。

関数または statement 属性	説明
SQL_ATTR_ROW_STATUS_PTR	SQLFetch と SQLFetchScroll によって入力される行ステータス配列のアドレスを設定します。 SQLSetPos がステートメント状態 S6 で呼び出された場合も、この配列は SQLSetPos によって入力されます。状態 S7 で SQLSetPos が呼び出された場合、この配列は塗りつぶされませんが、SQLExtendedFetch の RowStatusArray 引数が指す配列が入力されます。詳細については、「付録 B: ODBC 状態遷移テーブル」の「ステートメント遷移」を参照してください。
SQL_ATTR_ROWS_FETCHED_PTR	SQLFetch と SQLFetchScroll がフェッチされた行数を返すバッファーのアドレスを設定します。 SQLExtendedFetch が呼び出された場合、このバッファーは入力されませんが、RowCountPtr 引数はフェッチされた行数を指します。
SQL_ATTR_ROW_ARRAY_SIZE	SQLFetch と SQLFetchScroll で使用される行セットサイズを設定します。
SQL_ROWSET_SIZE	SQLExtendedFetch で使用される行セットのサイズを設定します。 ODBC 3.x ドライバーは、SQLExtendedFetch または SQLSetPos を呼び出す ODBC 2.x アプリケーションで動作する場合に、これを実装します。
SQLBulkOperations	ODBC 3.x ドライバーが、SQL_ADDの操作で SQLSetPos を使用する ODBC 2.x アプリケーションで動作する必要がある場合、ドライバーは、SQL_ADDの操作を使用した SQLBulkOperations に加えて、SQL_ADDの操作で SQLSetPos をサポートする必要があります。
SQLExtendedFetch	指定した行セットを返します。 ODBC 3.x ドライバーは、SQLExtendedFetch または SQLSetPos を呼び出す ODBC 2.x アプリケーションで動作する場合に、これを実装します。実装の詳細を次に示します。 - ドライバーは、SQL_ROWSET_SIZE ステートメント属性の値から行セットサイズを取得します。 - ドライバーは、SQL_ATTR_ROW_STATUS_PTR ステートメント属性ではなく、 RowStatusArray 引数から行状態配列のアドレスを取得します。 SQLExtendedFetch の呼び出しの RowStatusArray 引数を null ポインターにすることはできません。 (ODBC 3.x では、SQL_ATTR_ROW_STATUS_PTR ステートメント属性に null ポインターを指定できることに注意してください)。 - ドライバーは、SQL_ATTR_ROWS_FETCHED_PTR ステートメント属性ではなく、 RowCountPtr 引数からフェッチされた行のバッファーのアドレスを取得します。 - ドライバーは SQLSTATE 01S01 (行内のエラー) を返し、 SQLExtendedFetch の呼び出しによって行がフェッチされている間にエラーが発生したことを示します。 ODBC 3.x ドライバーは、SQLFetch または SQLFetchScroll が呼び出されたときではなく、SQLExtendedFetch が呼び出された場合にのみ SQLSTATE 01S01 (行のエラー) を返す必要があります。下位互換性を維持するために、SQLState 01S01 (行内のエラー) が SQLExtendedFetch によって返された場合、ドライバーマネージャーは、 SQLGetDiagField の [状態レコードのシーケンス] セクションに記載されている規則に従って、エラーキュー内の状態レコードを並べ替えません。
SQLFetch	次の行セットを返します。実装の詳細を次に示します。 - ドライバーは、SQL_ATTR_ROW_ARRAY_SIZE ステートメント属性の値から行セットサイズを取得します。 - ドライバーは、SQL_ATTR_ROW_STATUS_PTR ステートメント属性から行の状態配列のアドレスを取得します。 - ドライバーは、SQL_ATTR_ROWS_FETCHED_PTR ステートメント属性からフェッチされた行バッファーのアドレスを取得します。 - アプリケーションは、 SQLFetchScroll と SQLFetch の間で呼び出しを混在させることができます。 - 列 0 がバインドされている場合、SQLFetch はブックマークを返します。 - SQLFetch を呼び出して、複数の行を返すことができます。 - SQLFetch の呼び出しによって行がフェッチされている間にエラーが発生したことを示すために、ドライバーは SQLSTATE 01S01 (行内のエラー) を返しません。
SQLFetchScroll	指定した行セットを返します。実装の詳細を次に示します。 - ドライバーは、SQL_ATTR_ROW_ARRAY_SIZE ステートメント属性から行セットのサイズを取得します。 - ドライバーは、SQL_ATTR_ROW_STATUS_PTR ステートメント属性から行の状態配列のアドレスを取得します。 - ドライバーは、SQL_ATTR_ROWS_FETCHED_PTR ステートメント属性からフェッチされた行バッファーのアドレスを取得します。 - アプリケーションは、 SQLFetchScroll と SQLFetch の間で呼び出しを混在させることができます。 - SQLFetchScroll の呼び出しによって行がフェッチされている間にエラーが発生したことを示すために、ドライバーは SQLSTATE 01S01 (行内のエラー) を返しません。
SQLSetPos	さまざまな配置操作を実行します。実装の詳細を次に示します。 - これは、ステートメント状態 S6 または S7 で呼び出すことができます。詳細については、「付録 B: ODBC 状態遷移テーブル」の「ステートメント遷移」を参照してください。 - これがステートメント状態 S5 または S6 で呼び出された場合、ドライバーは SQL_ATTR_ROWS_FETCHED_PTR ステートメント属性から行セットサイズを取得し、SQL_ATTR_ROW_STATUS_PTR ステートメント属性から行状態配列のアドレスを取得します。 - これがステートメント状態 S7 で呼び出された場合、ドライバーは SQL_ROWSET_SIZE ステートメント属性から行セットサイズを取得し、SQLExtendedFetch の RowStatusArray 引数から行状態配列のアドレスを取得します。 - ドライバーは、SQLSTATE 01S01 (行内のエラー) を返します。これは、 SQLSetPos の呼び出しによって行がフェッチされ、関数が状態 S7 で呼び出されたときに一括操作を実行するときにエラーが発生したことを示すためだけに行われます。下位互換性を維持するために、SQLState 01S01 (行のエラー) が SQLSetPos によって返された場合、ドライバーマネージャーは、 SQLGetDiagField の [状態レコードのシーケンス] セクションに記載されている規則に従って、エラーキュー内の状態レコードを並べ替えません。 - ドライバーが、SQL_ADD の Operation 引数を持つ SQLSetPos を呼び出す ODBC 2.x アプリケーションで動作する必要がある場合、ドライバーは、SQL_ADD の Operation 引数を持つ SQLSetPos をサポートする必要があります。