行セット内の行を SQLSetPos() を使用して更新する

SQLSetPos() を使用して、行セット内の行を更新できます。動的カーソルによって、SQLSetPos() は現在行セット上で作動します。SQLSetPos() は、バインドされた各列のアプリケーション・バッファーにあるデータを使用して行を更新します。データ長が SQL_COLUMN_IGNORE 値であるバインド済みのすべての列と、アンバインド済みのすべての列は更新されません。

始める前に

SQLSetPos() を呼び出す前に、SQLFetch() または SQLFetchScroll() を呼び出す必要があります。

手順

SQLSetPos() を使用して行を更新するには、以下のようにします。

  1. SQLBindCol() を呼び出して、更新するデータをバインドします。
    1. バインドされた各列に対し、rgbValue 引数で指定されたバッファーに新しいデータ値を置き、pcbValue 引数で指定されたバッファーに値の長さを置きます。
    2. 更新しない列のデータ値の長さに SQL_COLUMN_IGNORE を設定します。
  2. Operation を SQL_UPDATE に設定し、RowNumber を更新する行数に設定して SQLSetPos() を呼び出します。 RowNumber を 0 に設定すると、行セット内のすべての行が更新されます。

    RowNumber を 0 に設定したが、ある特定の行のみを更新する場合は、SQL_ATTR_ROW_OPERATION_PTR ステートメント属性によって SQL_ROW_IGNORE に示された行操作配列に対応するエレメントを設定することによって、その他の行の更新を無効にできます。

例

以下の例は、SQLSetPos() を使用して、表 CUSTOMER 内の行を更新するアプリケーションです。
#define ROWSET_SIZE 10
/* Declare and initialize local variables        */
SQLCHAR sqlstmt[] =
  "SELECT Cust_Num, First_Name, Last_Name FROM CUSTOMER";
SQLINTEGER Cust_Num;
SQLCHAR First_Name[ROWSET_SIZE][21];
SQLCHAR Last_Name[ROWSET_SIZE][21];
SQLINTEGER Cust_Num_L[ROWSET_SIZE];
SQLINTEGER First_Name_L[ROWSET_SIZE];
SQLINTEGER Last_Name_L[ROWSET_SIZE];
SQLUSMALLINT rowStatus[ROWSET_SIZE];
/* Set up dynamic cursor type                    */
rc = SQLSetStmtAttr(hstmt,
  SQL_ATTR_CURSOR_TYPE,
  (SQLPOINTER) SQL_CURSOR_DYNAMIC,
  0);
/* Set pointer to row status array               */
rc = SQLSetStmtAttr(hstmt,
  SQL_ATTR_ROW_STATUS_PTR,
  (SQLPOINTER) rowStatus,
  0);
/* Set number of rows to fetch                   */
rc = SQLSetStmtAttr(hstmt,
  SQL_ATTR_ROW_ARRAY_SIZE,
  (SQLPOINTER) ROWSET_SIZE,
  0);
/* Fetch the first rowset                        */
rc = SQLFetchScroll(hstmt, SQL_FETCH_FIRST, 0);
/* Call SQLBindCol() for each result set column  */
rc = SQLBindCol(hstmt,
  1,
  SQL_C_LONG,
  (SQLPOINTER) Cust_Num,
  (SQLINTEGER) sizeof(Cust_Num)/ROWSET_SIZE,
  Cust_Num_L);
rc = SQLBindCol(hstmt,
  2,
  SQL_C_CHAR,
  (SQLPOINTER) First_Name,
  (SQLINTEGER) sizeof(First_Name)/ROWSET_SIZE,
  First_Name_L);
rc = SQLBindCol(hstmt,
  3,
  SQL_C_CHAR,
  (SQLPOINTER) Last_Name,
  (SQLINTEGER) sizeof(Last_Name)/ROWSET_SIZE,
  Last_Name_L);
…
/* For each column, place the new data value in  */
/* the rgbValue buffer, and set the length of    */
/* the value in the buffer specified by the      */
/* pcbValue argument                             */
…
/* Update the first row in the rowset            */
rc = SQLSetPos(hstmt, 1, SQL_UPDATE, SQL_LOCK_NO_CHANGE);