CRecordset::CheckRowsetError
レコードのフェッチ中に発生するエラーを処理するために呼び出されます。
virtual void CheckRowsetError(
RETCODE nRetCode
);
パラメーター
- nRetCode
ODBC API 関数のリターン コード。詳細については、「解説」を参照してください。
解説
この仮想メンバー関数は、レコードがフェッチ発生し、バルク行フェッチ中にある場合にエラーを処理します。独自のエラー処理を実行するに CheckRowsetError をオーバーライドすることを検討する必要があります。
CheckRowsetError は [開く]、[再クエリ]、または [移動] 操作などのカーソルの移動操作で、自動的に呼び出されます。の戻り値 SQLExtendedFetchな ODBC API 関数に渡されます。nRetCode パラメーターとして使用できる値の一覧を次の表に示します。
nRetCode |
説明 |
|---|---|
SQL_SUCCESS |
正常に完了する関数; 追加情報は使用できません。 |
SQL_SUCCESS_WITH_INFO |
関数は、重大エラーと、おそらくは正常に完了しました。追加情報は SQLErrorを呼び出して取得できます。 |
SQL_NO_DATA_FOUND |
結果セットのすべての行がフェッチします。 |
SQL_ERROR |
関数が失敗しました。追加情報は SQLErrorを呼び出して取得できます。 |
SQL_INVALID_HANDLE |
無効な環境のハンドル、接続のハンドル、またはステートメントのハンドルが関数で失敗した原因で。これは、プログラミング エラーを示します。追加情報は SQLErrorから使用できません。 |
SQL_STILL_EXECUTING |
非同期に開始された関数はまだ実装されています。は、MFC は渡しません CheckRowsetErrorにこの値を既定では許可しません。; MFC は、SQL_STILL_EXECUTINGを返さないまで SQLExtendedFetch の呼び出しを継続します。 |
SQLErrorに関する詳細については、Windows SDKを参照してください。バルク行フェッチに関する詳細については、" " レコードセット: フェッチ サイズのレコードを (ODBC)を参照してください。
例外
このメソッドは、型 **CDBException***の例外をスローできます。
必要条件
Header: afxdb.h