CRecordset::CheckRowsetError
呼叫處理記錄擷取時產生的錯誤。
virtual void CheckRowsetError(
RETCODE nRetCode
);
參數
- nRetCode
ODBC API 函式傳回碼。如需詳細資訊,請參閱"備註"。
備註
這個虛擬成員函式處理所發生的錯誤,當資料錄被擷取時,並不在大量資料列擷取時很有用。您可以考慮覆寫 CheckRowsetError 實作您的錯誤處理。
在CheckRowsetError 游標巡覽作業會自動呼叫,例如 開啟Requery、,或任何 移動 作業。它會透過 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 會繼續執行呼叫 SQLExtendedFetch ,直到它不再傳回 SQL_STILL_EXECUTING。 |
如需 SQLError的資訊,請參閱 Windows SDK。如需大量資料列擷取的詳細資訊,請參閱本文 資料錄集:擷取大量資料錄 (ODBC)。
例外狀況
這個方法會擲回型別 **CDBException***的例外狀況。
需求
Header: afxdb.h