詳細な説明の開始
この図は、データを分割して送るプロセス、およびデータを分割して取り出すプロセスで使用する 関数を表したフローチャートです。 この説明では、データを分割して送ることと、データを分割して取り出すことがそれぞれ別の 2 つの表で 表されています。
次の表では、データを分割して送る関数を呼び出すプロセスを記述しています。
この表の中の各行は、必要な関数呼び出し、オプションの関数呼び出し、または
どちらの関数呼び出しをこのプロセス内で選択すればよいかを表しています。
これらの関数はアプリケーションで呼び出される順序で記載してあります。
| 関数呼び出し | 使用法 | 説明 |
|---|---|---|
| SQLAllocHandle() | 必要 | ステートメント・ハンドルを割り振ります。 |
| SQLBindParameter() | 必要 | SQL ステートメントのパラメーター・マーカーをアプリケーション変数にバインドし ます。SQL_DATA_AT_EXEC を引数 fParamType に指定して、この関数を呼び出し ます。SQL ステートメントのそれぞれのパラメーター・マーカーごとに、この呼び出しを繰り返します。 |
| SQLPrepare() および SQLExecute()、 あるいは SQLExecDirect() | 必要な選択 | SQL 照会を準備し、実行します。実行時データ・パラメーターに対して SQL_NEED_DATA を戻します。 |
| SQLParamData() | SQL_NEED_DATA が戻される場合は必要 | 実行時データのプロセスを初期化します。 |
| SQLPutData() | SQL_NEED_DATA が戻される場合は必要 | 現在データを必要としているパラメーター・マーカーに対して、データを一部分を送ります。 送られる各データ部分ごとに、この関数への呼び出しを繰り返します。 |
| SQLParamData() | SQL_NEED_DATA が戻される場合は必要 | データのすべての部分が送られたことを示します。SQL_NEED_DATA が戻された場合は 、追加で SQLPutData() および SQLParamData() への呼び出しを行って、次のパラメーター・マーカーのデータを送る必要があります。 |
| SQLFreeHandle() | オプション | ステートメント・ハンドルを解放します。 |
次の表では、データを分割して取り出す関数を呼び出すプロセスを記述しています。
この表の中の各行は、必要な関数呼び出し、オプションの関数呼び出し、または
どちらの関数呼び出しを選択すればよいかを表しています。
これらの関数はアプリケーションで呼び出される順序で記載してあります。
| 関数呼び出し | 使用法 | 説明 |
|---|---|---|
| SQLAllocHandle() | 必要 | ステートメント・ハンドルを割り振ります。 |
| SQLPrepare() および SQLExecute()、 あるいは SQLExecDirect() | 必要な選択 | SQL 照会を準備し、実行します。 |
| SQLFetch( ) | 必要 | 結果セットのフェッチ |
| SQLGetData() | 必要 | 列データをアプリケーション変数に入れます。 この関数が SQL_SUCCESS_WITH_INFO を戻した場合は、SQL_SUCCESS を戻すまでこの関数を繰り返します。 |
| SQLFreeHandle() | オプション | ステートメント・ハンドルを解放します。 |
詳細な説明の終了