CRecordset::CheckRowsetError
调用记录获取过程中发生的错误。
virtual void CheckRowsetError(
RETCODE nRetCode
);
参数
- nRetCode
ODBC API函数返回代码。有关详细信息,请参见备注。
备注
此生成的虚拟成员函数处理错误,在记录中获取时,在批量取行时很有用。您可能要考虑重写 CheckRowsetError 实现错误处理。
CheckRowsetError 在光标导航操作自动调用,例如 Open、 Requery,或者所有 Move 操作。它通过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