詳細な説明の開始
この図は、一度に結果セットの 1 行を取り出すプロセスと、結果セットを直接、配列の中に 取り出すプロセスを比較したフローチャートです。 この記述では、2 つのプロセスを別々に説明しています。
次の表では、結果セットを一度に 1 行取り出す関数を呼び出すプロセスを記述しています。
この表の中の各行は、必要な関数呼び出し、オプションの関数呼び出し、または
どちらの関数呼び出しをこのプロセス内で選択すればよいかを表しています。
これらの関数はアプリケーションで呼び出される順序で記載してあります。
| 関数呼び出し | 使用法 | 説明 |
|---|---|---|
| SQLAllocHandle() | 必要 | ステートメント・ハンドルを割り振ります。 |
| SQLPrepare() および SQLExecute()、 あるいは SQLExecDirect() | 必要な選択 | SQL 照会を準備し、実行します。この照会は、n 行 m 列の結果セットを 戻します。 |
| SQLBindCol() | 必要 | 結果セットのそれぞれの列をアプリケーション変数にバインドします。 m 列の場合、この関数を m 回呼び出します。 |
| SQLFetch( ) | 必要 | バインドされたアプリケーション変数の中に、現在行をフェッチします。 n 行の場合、この関数を n 回呼び出します。 |
| SQLFreeHandle() | オプション | ステートメント・ハンドルを解放します。 |
次の表では、結果セットを取り出して直接配列に入れる複数の関数呼び出しのプロセスを記述しています。
この表の中の各行は、必要な関数呼び出し、オプションの関数呼び出し、または
どちらの関数呼び出しをこのプロセス内で選択すればよいかを表しています。
これらの関数はアプリケーションで呼び出される順序で記載してあります。
| 関数呼び出し | 使用法 | 説明 |
|---|---|---|
| SQLAllocHandle() | 必要 | ステートメント・ハンドルを割り振ります。 |
| SQLSetStmtAttr() | 必要 | 結果セットを列方向にバインドするのか、行方向にバインドするのかを指定します。
結果セットを列方向にバインドしようとする場合は、SQLSetStmtAttr() を呼び出して以下の属性を設定します。
結果セットを行方向にバインドしようとする場合は、SQLSetStmtAttr() を呼び出して、次の属性を設定します。
|
| SQLPrepare() および SQLExecute()、 あるいは SQLExecDirect() | 必要な選択 | SQL 照会を準備し、実行します。この照会は、n 行 m 列から成る結果セットを 戻します。 |
| SQLBindCol() | 必要 | 結果セットの列を配列にバインドするか (SQL_ATTR_BIND_TYPE 属性を設定して SQL_BIND_BY_COLUMN にする場合)、 あるいは列を構造のコンポーネントにバインドします (SQL_ATTR_BIND_TYPE 属性を設定 して sizeof(struct StructName) にする場合)。m 列の場合、この関数を m 回呼び出します。 |
| SQLExtendedFetch() | 必要 | 結果セット全体をフェッチして、バインドされた配列またはバインドされた構造に入れます。 |
| SQLFreeHandle() | オプション | ステートメント・ハンドルを解放します。 |
詳細な説明の終了