CRecordset::CheckRowsetError

仮想 void CheckRowsetError (RETCODE nRetCode );
(CDBException) をスロー;

パラメーター

nRetCode

ODBC API 関数のリターン コード。詳細については、「解説」を参照してください。

解説

この仮想メンバー関数はレコードがフェッチされるときに発生するエラー処理とバルク行フェッチ中に便利です。CheckRowsetErrorをオーバーライドする独自のエラー処理を実装するために考慮する必要があります。

CheckRowsetErrorは、カーソルのナビゲーション操作を使用して、開いてクエリを再実行または移動操作などで自動的に呼び出されます。それは、ODBC API 関数SQLExtendedFetchの戻り値を渡されます。次の表に、 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の詳細については、 ODBC SDK programmer's Referenceを参照してください。バルク行フェッチの詳細については、資料を参照してください レコード セット: レコードのフェッチ一括 (ODBC)Visual の C++ プログラマのガイド

CRecordset の概要|nbsp;クラス メンバー |階層図(&N)

参照特価;CRecordset::DoBulkFieldExchangeCRecordset::GetRowsetSizeCRecordset::SetRowsetSizeCRecordset::Move(&N)

Index