16.9.1　SQLRowCount : Hitachi Advanced Data Binder AP開発ガイド

(1)　機能

この関数を実行する前に行われた次の処理で変更された行数を返します。

SQLRETURN SQLRowCount
(
  SQLHSTMT       StatementHandle,     /* In */
  SQLLEN       * RowCountPtr          /* Out */
)

StatementHandle：

ステートメントハンドルを指定します。

この関数を実行する前にSQLAllocHandleの*OutputHandlePtrで出力された値を指定します。

RowCountPtr：

変更された行カウントを返すバッファを指すポインタを指定します。

SQL_SUCCESS，SQL_ERROR，またはSQL_INVALID_HANDLEが返されます。

この関数では次のSQLSTATEを返します。

SQLSTATE	説明	備考	返却
01000	一般警告	−	×
HY000	一般エラー		×
HY001	メモリ割り当てエラー		×
HY009	NULLポインタの不正使用	RowCountPtrに無効な値が設定されました。	○
HY010	関数シーケンスエラー	−	○
HY013	メモリ管理エラー		×
HY117	接続がサスペンド中		×
HYT01	接続タイムアウト終了		×
IM001	ドライバはこの関数をサポートしていない		×

（凡例）

○：HADB ODBCドライバが返すことがあるSQLSTATEです。

×：HADB ODBCドライバが返さないSQLSTATEです。

−：なし。

実行したSQL文がUPDATE文，INSERT文またはDELETE文のどれかの場合，要求によって変更された行数を返します。ただし，次に示す場合は，-1を返します。