virtual void CheckRowsetError (RETCODE nRetCode );
lançar (CDBException);
Parâmetros
nRetCode
Código de retorno de uma função de API de ODBC. Para obter detalhes, consulte "Comentários".
Observações
Esta função de membro virtual manipula erros que ocorrem quando registros são obtidos, e é útil durante a busca de linha em massa. Você pode querer considerar substituir CheckRowsetError para implementar seu próprio Manipulação de erros.
CheckRowsetError é chamado automaticamente em uma operação de navegação de cursor, tais como Open, RepetirConsultaou qualquer operação de Mover . Ele é passado o valor de retorno da função de API de ODBC SQLExtendedFetch. A tabela a seguir lista os possíveis valores para o parâmetro nRetCode.
| nRetCode | Descrição |
| SQL_SUCCESS | Função foi concluída com êxito; nenhuma informação adicional está disponível. |
| SQL_SUCCESS_WITH_INFO | Função foi concluída com êxito, possivelmente com um erro nonfatal. Informações adicionais podem ser obtidas chamando SQLError. |
| SQL_NO_DATA_FOUND | Todas as linhas no conjunto de resultados foram obtidas. |
| SQL_ERROR | Falha na função. Informações adicionais podem ser obtidas chamando SQLError. |
| SQL_INVALID_HANDLE | Função falhou devido a um identificador de ambiente inválido, identificador de conexão ou identificador de instrução. Isso indica um erro de programação. Nenhuma informação adicional estará disponível de SQLError. |
| SQL_STILL_EXECUTING | Uma função que foi iniciada de forma assíncrona ainda está em execução. Observe que, por padrão, o MFC será nunca passar esse valor para CheckRowsetError; MFC continuará chamada SQLExtendedFetch até que ele não retornará SQL_STILL_EXECUTING. |
Para obter mais informações sobre SQLError, consulte o Referência do programador ODBC SDK. Para obter mais informações sobre a linha em massa buscando, consulte o artigo Recordset: Buscar registros em massa (ODBC) no Guia do programador do Visual C++.
Visão geral de CRecordset | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;CRecordset::DoBulkFieldExchange, CRecordset::GetRowsetSize, CRecordset::SetRowsetSize, CRecordset::Move