SQLSetPos 関数

準拠
導入されたバージョン: ODBC 1.0 Standards Compliance: ODBC

まとめ
SQLSetPos は、行セット内のカーソル位置を設定し、アプリケーションが行セット内のデータを更新したり、結果セット内のデータを更新または削除したりできます。

構文

  
SQLRETURN SQLSetPos(  
      SQLHSTMT        StatementHandle,  
      SQLSETPOSIROW   RowNumber,  
      SQLUSMALLINT    Operation,  
      SQLUSMALLINT    LockType);  

引数

StatementHandle
[入力]ステートメント ハンドル。

RowNumber
[入力]Operation 引数で指定された操作を実行する行セット内の行の位置。 RowNumber が 0 の場合、操作は行セット内のすべての行に適用されます。

詳細については、「コメント」を参照してください。

操作
[入力]実行する操作:

SQL_POSITION SQL_REFRESH SQL_UPDATE SQL_DELETE

詳細については、「コメント」を参照してください。

LockType
[入力]Operation 引数で指定された操作を実行した後に行をロックする方法を指定します。

SQL_LOCK_NO_CHANGE SQL_LOCK_EXCLUSIVE SQL_LOCK_UNLOCK

詳細については、「コメント」を参照してください。

返品

SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_NEED_DATA、SQL_STILL_EXECUTING、SQL_ERROR、またはSQL_INVALID_HANDLE。

診断

SQLSetPos がSQL_ERRORまたはSQL_SUCCESS_WITH_INFOを返す場合、関連付けられている SQLSTATE 値を取得するには、SQL_HANDLE_STMTの HandleType と StatementHandle のハンドルを使用して SQLGetDiagRec を呼び出します。 次の表に、SQLSetPos によって一般的に返される SQLSTATE 値の一覧を示し、この関数のコンテキストでそれぞれについて説明します。"(DM)" という表記は、ドライバー マネージャーによって返される SQLSTATE の説明の前にあります。 特に明記されていない限り、各 SQLSTATE 値に関連付けられている戻りコードはSQL_ERROR。

SQL_SUCCESS_WITH_INFOまたはSQL_ERRORを返すことができるすべての SQLSTATEs (01xxx SQLSTATEs を除く) に対して、複数行操作の 1 つ以上の行でエラーが発生した場合はSQL_SUCCESS_WITH_INFOが返され、1 行の操作でエラーが発生した場合はSQL_ERRORが返されます。

Comments

RowNumber 引数

引数 RowNumber は、Operation 引数で指定された操作を実行する行セット内の行の数を指定します。 RowNumber が 0 の場合、操作は行セット内のすべての行に適用されます。 RowNumber は、0 から行セット内の行数までの値である必要があります。

すべての操作は、RowNumber で指定された行にカーソルを置きます。 次の操作にはカーソル位置が必要です。

• 配置された更新ステートメントと delete ステートメント。

• SQLGetData の呼び出し。

• SQL_DELETE、SQL_REFRESH、およびSQL_UPDATEオプションを使用した SQLSetPos の呼び出し。

たとえば、SQL_DELETEの操作を使用した SQLSetPos の呼び出しで RowNumber が 2 の場合、カーソルは行セットの 2 番目の行に配置され、その行は削除されます。 2 番目の行の実装行状態配列 (SQL_ATTR_ROW_STATUS_PTR ステートメント属性が指す) のエントリがSQL_ROW_DELETEDに変更されます。

アプリケーションは、SQLSetPos を呼び出すときにカーソル位置を指定できます。 一般に、SQLSetPos は、SQL_POSITIONまたはSQL_REFRESH操作を使用して呼び出し、位置指定された更新または削除ステートメントを実行する前または SQLGetData を呼び出す前にカーソルを配置します。

Operation 引数

Operation 引数は、次の操作をサポートします。 データ ソースでサポートされているオプションを決定するために、アプリケーションは、SQL_DYNAMIC_CURSOR_ATTRIBUTES1、SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1、SQL_KEYSET_CURSOR_ATTRIBUTES1、またはSQL_STATIC_CURSOR_ATTRIBUTES1情報の種類 (カーソルの種類に応じて) を使用して SQLGetInfo を呼び出します。

LockType 引数

LockType 引数は、アプリケーションがコンカレンシーを制御する方法を提供します。 ほとんどの場合、コンカレンシー レベルとトランザクションをサポートするデータ ソースでは、LockType 引数のSQL_LOCK_NO_CHANGE値のみがサポートされます。 LockType 引数は、通常、ファイル ベースのサポートにのみ使用されます。

LockType 引数は、SQLSetPos が実行された後の行のロック状態を指定します。 ドライバーは、要求された操作を実行するか、LockType 引数を満たすために行をロックできない場合は、SQL_ERRORおよび SQLSTATE 42000 (構文エラーまたはアクセス違反) を返します。

LockType 引数は 1 つのステートメントに対して指定されていますが、ロックは接続上のすべてのステートメントに同じ権限を付与します。 特に、接続上の 1 つのステートメントによって取得されるロックは、同じ接続上の別のステートメントによってロック解除できます。

LOCKType が SQL_LOCK_UNLOCK に設定された行に対してアプリケーションが SQLSetPos を呼び出すまで、またはアプリケーションがステートメントに対して SQLFreeHandle を呼び出すまで、または SQL_CLOSE オプションを指定して SQLFreeStmt を呼び出すまで、SQLSetPos によってロックされた行はロックされたままになります。 トランザクションをサポートするドライバーの場合、アプリケーションが SQLEndTran を呼び出して接続上のトランザクションをコミットまたはロールバックすると、SQLSetPos によってロックされた行がロック解除されます (トランザクションがコミットまたはロールバックされたときに、SQLGetInfo によって返されるSQL_CURSOR_COMMIT_BEHAVIORとSQL_CURSOR_ROLLBACK_BEHAVIOR情報の種類によって示されている場合)。

LockType 引数は、次の種類のロックをサポートします。 データ ソースでサポートされているロックを特定するために、アプリケーションは、SQL_DYNAMIC_CURSOR_ATTRIBUTES1、SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1、SQL_KEYSET_CURSOR_ATTRIBUTES1、またはSQL_STATIC_CURSOR_ATTRIBUTES1情報の種類 (カーソルの種類に応じて) を使用して SQLGetInfo を呼び出します。

ドライバーがSQL_LOCK_EXCLUSIVEをサポートしているが、SQL_LOCK_UNLOCKをサポートしていない場合、ロックされている行は、前の段落で説明した関数呼び出しのいずれかが発生するまでロックされたままになります。

ドライバーがSQL_LOCK_EXCLUSIVEをサポートしているが、SQL_LOCK_UNLOCKをサポートしていない場合、アプリケーションがステートメントに対して SQLFreeHandle を呼び出すか、SQL_CLOSE オプションを指定して SQLFreeStmt を呼び出すまで、ロックされている行はロックされたままになります。 ドライバーがトランザクションをサポートし、トランザクションのコミットまたはロールバック時にカーソルを閉じる場合、アプリケーションは SQLEndTran を呼び出します。

SQLSetPos の更新操作と削除操作の場合、アプリケーションは LockType 引数を次のように使用します。

• 取得後に行が変更されないことを保証するために、アプリケーションは、Operation を SQL_REFRESH に設定し、LockType を SQL_LOCK_EXCLUSIVE に設定して SQLSetPos を呼び出します。

• アプリケーションが LockType を SQL_LOCK_NO_CHANGE に設定した場合、ドライバーは、アプリケーションがSQL_ATTR_CONCURRENCY ステートメント属性にSQL_CONCUR_LOCK指定した場合にのみ、更新または削除操作が成功することを保証します。

• アプリケーションで SQL_ATTR_CONCURRENCY ステートメント属性のSQL_CONCUR_ROWVERまたはSQL_CONCUR_VALUESが指定されている場合、ドライバーは行のバージョンまたは値を比較し、アプリケーションが行をフェッチしてから行が変更された場合、操作を拒否します。

• アプリケーションで SQL_ATTR_CONCURRENCY ステートメント属性のSQL_CONCUR_READ_ONLYが指定されている場合、ドライバーは更新操作または削除操作を拒否します。

SQL_ATTR_CONCURRENCY ステートメント属性の詳細については、「SQLSetStmtAttr」を参照してください。

状態配列と操作配列

SQLSetPos を呼び出すときは、次の状態と操作の配列が使用されます。

• 行ステータス配列 (IRD および SQL_ATTR_ROW_STATUS_ARRAY ステートメント属性の SQL_DESC_ARRAY_STATUS_PTR フィールドが指すように) には、行セット内のデータの各行の状態値が含まれます。 ドライバーは、SQLFetch、SQLFetchScroll、SQLBulkOperations、または SQLSetPos の呼び出し後に、この配列の状態値を設定します。 この配列は、SQL_ATTR_ROW_STATUS_PTR ステートメント属性によって指されます。

• 行操作配列 (ARD および SQL_ATTR_ROW_OPERATION_ARRAY ステートメント属性の SQL_DESC_ARRAY_STATUS_PTR フィールドが指すように) には、一括操作に対する SQLSetPos の呼び出しが無視されるか実行されるかを示す行セット内の各行の値が含まれます。 配列内の各要素は、SQL_ROW_PROCEED (既定値) またはSQL_ROW_IGNOREに設定されます。 この配列は、SQL_ATTR_ROW_OPERATION_PTR ステートメント属性によって指されます。

状態配列と操作配列内の要素の数は、(SQL_ATTR_ROW_ARRAY_SIZE ステートメント属性で定義されている) 行セット内の行数と等しい必要があります。

行ステータス配列の詳細については、SQLFetch を参照してください。 行操作配列の詳細については、このセクションで後述する「一括操作での行の無視」を参照してください。

SQLSetPos の使用

アプリケーションが SQLSetPos を呼び出す前に、次の一連の手順を実行する必要があります。

1. アプリケーションで操作が SQL_UPDATE に設定された SQLSetPos を呼び出す場合は、各列の SQLBindCol (または SQLSetDescRec) を呼び出して、そのデータ型を指定し、列のデータと長さのバッファーをバインドします。

2. アプリケーションで操作が SQL_DELETE または SQL_UPDATE に設定された SQLSetPos を呼び出す場合は、SQLColAttribute を呼び出して、削除または更新する列が更新可能であることを確認します。

3. SQLExecDirect、SQLExecute、またはカタログ関数を呼び出して、結果セットを作成します。

4. SQLFetch または SQLFetchScroll を呼び出してデータを取得します。

SQLSetPos の使用の詳細については、「SQLSetPos を使用したデータの更新」を参照してください。

SQLSetPos を使用したデータの削除

SQLSetPos を使用してデータを削除するために、アプリケーションは SQLSetPos を呼び出し、RowNumber を削除する行の数に設定し、Operation をSQL_DELETEに設定します。

データが削除されると、ドライバーは、適切な行の実装行の状態配列の値をSQL_ROW_DELETED (またはSQL_ROW_ERROR) に変更します。

SQLSetPos を使用したデータの更新

アプリケーションは、バインドされたデータ バッファー内または SQLPutData への 1 つ以上の呼び出しを使用して、列の値を渡すことができます。 SQLPutData でデータが渡される列は、実行時データ列と呼ばれます。 これらは通常、SQL_LONGVARBINARY列とSQL_LONGVARCHAR列のデータを送信するために使用され、他の列と混在させることができます。

SQLSetPos を使用してデータを更新するには、次の手順を実行します。

1. SQLBindCol でバインドされたデータ バッファーと長さ/インジケーター バッファーに値を 配置します。

   • 通常の列の場合、アプリケーションは新しい列の値を *TargetValuePtr バッファーに配置し、その値の長さを *StrLen_or_IndPtr バッファーに配置します。 行を更新しない場合、アプリケーションは行操作配列のその行の要素にSQL_ROW_IGNOREを配置します。

   • 実行時データ列の場合、アプリケーションはアプリケーション定義の値 (列番号など) を *TargetValuePtr バッファーに配置します。 この値は、後で列を識別するために使用できます。

     アプリケーションは、SQL_LEN_DATA_AT_EXEC(length) マクロの結果を *StrLen_or_IndPtr バッファーに配置します。 列の SQL データ型がSQL_LONGVARBINARY、SQL_LONGVARCHAR、または長いデータ ソース固有のデータ型であり、ドライバーが SQLGetInfo のSQL_NEED_LONG_DATA_LEN情報の種類に対して "Y" を返す場合、長さはパラメーターに送信されるデータのバイト数です。それ以外の場合は、負以外の値である必要があり、無視されます。

2. データ行を更新するために、Operation 引数を SQL_UPDATE に設定して SQLSetPos を呼び出します。

   • 実行時データ列がない場合、プロセスは完了です。

   • 実行中のデータ列がある場合、関数はSQL_NEED_DATAを返し、手順 3 に進みます。

3. SQLParamData を呼び出して、処理される最初の実行時データ列の *TargetValuePtr バッファーのアドレスを取得します。 SQLParamData はSQL_NEED_DATAを返します。 アプリケーションは、*TargetValuePtr バッファーからアプリケーション定義値を取得します。

   Note

   実行時データ パラメーターは実行データ列に似ていますが、SQLParamData によって返される値はそれぞれ異なります。

   Note

   実行時データ パラメーターは SQL ステートメントのパラメーターであり、SQLExecDirect または SQLExecute を使用してステートメントを実行すると、SQLPutData でデータが送信されます。 これらは、SQLBindParameter または SQLSetDescRec を使用して記述子を設定することによってバインドされます。 SQLParamData によって返される値は、ParameterValuePtr 引数で SQLBindParameter に渡される 32 ビット値です。

   Note

   実行時データ列は、行が SQLSetPos で更新されたときに SQLPutData でデータが送信される行セット内の列です。 これらは SQLBindCol にバインドされます。 SQLParamData によって返される値は、処理中の *TargetValuePtr バッファー内の行のアドレスです。

4. SQLPutData を 1 回以上呼び出して、列のデータを送信します。 SQLPutData で指定された *TargetValuePtr バッファーですべてのデータ値を返すことができない場合は、複数の呼び出しが必要です。同じ列に対する SQLPutData への複数の呼び出しは、文字、バイナリ、またはデータ ソース固有のデータ型を持つ列に文字 C データを送信する場合、または文字を持つ列にバイナリ C データを送信する場合にのみ許可されます。 バイナリまたはデータ ソース固有のデータ型。

5. SQLParamData をもう一度呼び出して、列のすべてのデータが送信されたことを通知します。

   • 実行中のデータ列がさらに存在する場合、 SQLParamData は、次に処理される実行時データ列の SQL_NEED_DATAと TargetValuePtr バッファーのアドレスを返します。 アプリケーションは手順 4 と 5 を繰り返します。

   • 実行データ列がそれ以上ない場合、プロセスは完了です。 ステートメントが正常に実行された場合、 SQLParamData はSQL_SUCCESSまたはSQL_SUCCESS_WITH_INFOを返します。実行に失敗した場合は、SQL_ERRORを返します。 この時点で、SQLParamData は SQLSetPos から返すことができる任意の SQLSTATE を返すことができます。

データが更新された場合、ドライバーは、適切な行の実装行の状態配列の値をSQL_ROW_UPDATEDに変更します。

操作がキャンセルされた場合、または SQLParamData または SQLPutData でエラーが発生した場合、SQLSetPos がSQL_NEED_DATAを返し、すべての実行時列に対してデータが送信される前に、アプリケーションはステートメントまたはステートメントに関連付けられている接続に対して SQLCancel、SQLGetDiagField、SQLGetDiagRec、SQLGetFunctions、SQLParamData、または SQLPutData のみを呼び出すことができます。 ステートメントまたはステートメントに関連付けられている接続に対して他の関数を呼び出すと、関数は SQL_ERROR および SQLSTATE HY010 (関数シーケンス エラー) を返します。

アプリケーションが SQLCancel を呼び出しても、ドライバーが実行中のデータ列のデータを必要とする場合、ドライバーは操作を取り消します。 その後、アプリケーションは SQLSetPos を再度呼び出すことができます。取り消しはカーソルの状態や現在のカーソル位置には影響しません。

カーソルに関連付けられているクエリ指定の SELECT リストに同じ列への参照が複数含まれている場合、エラーが生成されるか、ドライバーが重複した参照を無視して要求された操作を実行するかは、ドライバーによって定義されます。

一括操作の実行

RowNumber 引数が 0 の場合、ドライバーは、ステートメント属性が指す行操作配列内のフィールドにSQL_ROW_PROCEED値を持つ行セット内のすべての行の Operation 引数で指定された操作SQL_ATTR_ROW_OPERATION_PTR実行します。 これは、SQL_DELETE、SQL_REFRESH、またはSQL_UPDATEの Operation 引数の RowNumber 引数の有効な値ですが、SQL_POSITIONではありません。 操作が SQL_POSITION で RowNumber が 0 の SQLSetPos は、SQLSTATE HY109 (無効なカーソル位置) を返します。

SQLSTATE HYT00 (タイムアウト期限切れ) など、行セット全体に関連するエラーが発生した場合、ドライバーはSQL_ERRORと適切な SQLSTATE を返します。 行セット バッファーの内容は未定義であり、カーソル位置は変更されません。

1 つの行に関連するエラーが発生した場合、ドライバーは次のようになります。

• SQL_ATTR_ROW_STATUS_PTR ステートメント属性が指す行ステータス配列の行の要素をSQL_ROW_ERRORに設定します。

• エラー キューにエラーに対して 1 つ以上の追加の SQLSTATEs をポストし、診断データ構造の SQL_DIAG_ROW_NUMBER フィールドを設定します。

エラーまたは警告を処理した後、ドライバーが行セット内の残りの行の操作を完了した場合は、SQL_SUCCESS_WITH_INFOを返します。 したがって、エラーを返した行ごとに、エラー キューに 0 個以上の追加の SQLSTATEs が含まれます。 ドライバーがエラーまたは警告を処理した後に操作を停止した場合は、SQL_ERRORを返します。

ドライバーは、SQLSTATE 01004 (データの切り捨て) などの警告を返す場合、特定の行に適用されるエラー情報を返す前に、行セット全体または行セット内の不明な行に適用される警告を返します。 特定の行に対する警告と、それらの行に関するその他のエラー情報が返されます。

RowNumber が 0 に等しく、Operation がSQL_UPDATE、SQL_REFRESH、またはSQL_DELETEの場合、SQLSetPos が操作する行の数は、SQL_ATTR_ROWS_FETCHED_PTR ステートメント属性によって示されます。

RowNumber が 0 に等しく、Operation がSQL_DELETE、SQL_REFRESH、またはSQL_UPDATEの場合、操作の後の現在の行は、操作の前の現在の行と同じです。

一括操作の行を無視する

行操作配列を使用すると、SQLSetPos を使用した一括操作中に、現在の行セット内の行を無視する必要があることを示すことができます。 一括操作中に 1 つ以上の行を無視するようにドライバーに指示するには、アプリケーションで次の手順を実行する必要があります。

1. SQLSetStmtAttr を呼び出して、SQLUSMALLINT の配列を指すSQL_ATTR_ROW_OPERATION_PTRステートメント属性を設定します。 このフィールドは、SQLSetDescField を呼び出して ARD の SQL_DESC_ARRAY_STATUS_PTR ヘッダー フィールドを設定することによっても設定できます。そのためには、アプリケーションが記述子ハンドルを取得する必要があります。

2. 行操作配列の各要素を、次の 2 つの値のいずれかに設定します。

   • SQL_ROW_IGNORE、一括操作で行が除外されることを示します。

   • SQL_ROW_PROCEED、行が一括操作に含まれていることを示します。 (これは既定値です)。

3. SQLSetPos を呼び出して一括操作を実行します。

行操作配列には、次の規則が適用されます。

• SQL_ROW_IGNOREとSQL_ROW_PROCEEDは、SQL_DELETEまたはSQL_UPDATEの操作で SQLSetPos を使用する一括操作にのみ影響します。 SQL_REFRESHまたはSQL_POSITIONの操作を使用した SQLSetPos の呼び出しには影響しません。

• ポインターは既定で null に設定されます。

• ポインターが null の場合、すべての要素がSQL_ROW_PROCEEDに設定されているかのように、すべての行が更新されます。

• 要素を SQL_ROW_PROCEED に設定しても、その特定の行に対して操作が実行される保証はありません。 たとえば、行セット内の特定の行の状態がSQL_ROW_ERROR場合、ドライバーは、アプリケーションがSQL_ROW_PROCEED指定したかどうかに関係なく、その行を更新できない可能性があります。 アプリケーションでは、操作が成功したかどうかを確認するために、常に行の状態配列を確認する必要があります。

• SQL_ROW_PROCEEDは、ヘッダー ファイルで 0 として定義されます。 アプリケーションは、すべての行を処理するために、行操作配列を 0 に初期化できます。

• 行操作配列の要素番号 "n" が SQL_ROW_IGNORE に設定され、一括更新または削除操作を実行するために SQLSetPos が呼び出された場合、SQLSetPos の呼び出し後、行セット内の n 番目の行は変更されません。

• アプリケーションは、読み取り専用列を自動的にSQL_ROW_IGNOREに設定する必要があります。

一括操作での列の無視

1 つ以上の読み取り専用列に対する更新の試行によって生成される不要な処理診断を回避するために、アプリケーションはバインドされた長さ/インジケーター バッファーの値をSQL_COLUMN_IGNOREに設定できます。 詳細については、「SQLBindCol」を参照してください。

コード例

次の例では、アプリケーションを使用すると、ユーザーは ORDERS テーブルを参照し、注文の状態を更新できます。 カーソルは、行セット サイズが 20 のキーセットドリブンであり、行バージョンを比較するオプティミスティック コンカレンシー制御を使用します。 各行セットがフェッチされると、アプリケーションはそれを出力し、ユーザーが注文の状態を選択して更新できるようにします。 アプリケーションでは、SQLSetPos を使用して、選択した行にカーソルを置き、行の位置指定された更新を実行します。 (わかりやすくするために、エラー処理は省略されています)。

#define ROWS 20  
#define STATUS_LEN 6  
  
SQLCHAR        szStatus[ROWS][STATUS_LEN], szReply[3];  
SQLINTEGER     cbStatus[ROWS], cbOrderID;  
SQLUSMALLINT   rgfRowStatus[ROWS];  
SQLUINTEGER    sOrderID, crow = ROWS, irow;  
SQLHSTMT       hstmtS, hstmtU;  
  
SQLSetStmtAttr(hstmtS, SQL_ATTR_CONCURRENCY, (SQLPOINTER) SQL_CONCUR_ROWVER, 0);  
SQLSetStmtAttr(hstmtS, SQL_ATTR_CURSOR_TYPE, (SQLPOINTER) SQL_CURSOR_KEYSET_DRIVEN, 0);  
SQLSetStmtAttr(hstmtS, SQL_ATTR_ROW_ARRAY_SIZE, (SQLPOINTER) ROWS, 0);  
SQLSetStmtAttr(hstmtS, SQL_ATTR_ROW_STATUS_PTR, (SQLPOINTER) rgfRowStatus, 0);  
SQLSetCursorName(hstmtS, "C1", SQL_NTS);  
SQLExecDirect(hstmtS, "SELECT ORDERID, STATUS FROM ORDERS ", SQL_NTS);  
  
SQLBindCol(hstmtS, 1, SQL_C_ULONG, &sOrderID, 0, &cbOrderID);  
SQLBindCol(hstmtS, 2, SQL_C_CHAR, szStatus, STATUS_LEN, &cbStatus);  
  
while ((retcode == SQLFetchScroll(hstmtS, SQL_FETCH_NEXT, 0)) != SQL_ERROR) {  
   if (retcode == SQL_NO_DATA_FOUND)  
      break;  
   for (irow = 0; irow < crow; irow++) {  
      if (rgfRowStatus[irow] != SQL_ROW_DELETED)  
         printf("%2d %5d %*s\n", irow+1, sOrderID, NAME_LEN-1, szStatus[irow]);  
   }  
   while (TRUE) {  
      printf("\nRow number to update?");  
      gets_s(szReply, 3);  
      irow = atoi(szReply);  
      if (irow > 0 && irow <= crow) {  
         printf("\nNew status?");  
         gets_s(szStatus[irow-1], (ROWS * STATUS_LEN));  
         SQLSetPos(hstmtS, irow, SQL_POSITION, SQL_LOCK_NO_CHANGE);  
         SQLPrepare(hstmtU,  
          "UPDATE ORDERS SET STATUS=? WHERE CURRENT OF C1", SQL_NTS);  
         SQLBindParameter(hstmtU, 1, SQL_PARAM_INPUT,  
            SQL_C_CHAR, SQL_CHAR,  
            STATUS_LEN, 0, szStatus[irow], 0, NULL);  
         SQLExecute(hstmtU);  
      } else if (irow == 0) {  
         break;  
      }  
   }  
}  

その他の例については、「位置指定された更新および削除ステートメント」および「SQLSetPos を使用した行セット内の行の更新」を参照してください。

関連する関数

参照

ODBC API リファレンス
ODBC ヘッダー ファイル