関数の戻りコード

すべての ODBC 関数は、関数呼び出しが成功したか失敗したかを示す、戻りコードを戻します。

次の表は、Db2® ODBC 関数で起こりうるすべての 戻りコードを示しています。

表 1. Db2 ODBC 関数の戻りコード
戻りコード 説明
SQL_SUCCESS 関数が正常に終了し、追加の SQLSTATE 情報はありません。
SQL_SUCCESS_WITH_INFO 関数は正常に完了しましたが、警告または他の情報があります。 SQLGetDiagRec() を呼び出して、SQLSTATE またはその他の通知メッセージ、 あるいは警告を受け取ってください。SQLSTATE クラスは、'01' です。
SQL_NO_DATA_FOUND 関数から正常に戻りましたが、関連データが見つかりませんでした。SQL ステートメントの 実行後にこれが戻される場合、追加情報がある可能性が あり、SQLGetDiagRec() を呼び出してこれを取得することができます。
SQL_NEED_DATA アプリケーションは SQL ステートメントを実行しようとしましたが、 アプリケーションが実行時に渡されるよう指示したパラメーター・データ が Db2 ODBC にありませんでした。
SQL_ERROR 関数は失敗しました。 SQLGetDiagRec() を呼び出して、SQLSTATE およびその他の エラー情報を受け取ってください。
SQL_INVALID_HANDLE 関数は、無効な入力ハンドル (環境ハンドル、接続ハンドル、また はステートメント・ハンドル) のために失敗しました。 これはプログラミング・エラーです。 それ以上の情報はありません。