CRecordset::CheckRowsetError

Artigo
08/25/2010

Chamado para manipular erros gerados durante a busca do registro.

virtual void CheckRowsetError( 
   RETCODE nRetCode  
);

Parâmetros

nRetCode
Uma função ODBC API código de retorno.Para obter detalhes, consulte comentários.

Comentários

Essa função de membro virtual trata os erros que ocorrem quando registros são obtidos, e é útil durante a busca de linha em massa.Convém considerar a substituição CheckRowsetError para implementar seu próprio tratamento de erro.

CheckRowsetError é chamado automaticamente em uma operação de navegação do cursor, sistema autônomo em aberto, Repetir a consulta, or any Mover operação.Ele é passado o valor retornado do ODBC API função SQLExtendedFetch.A tabela a seguir lista os valores possíveis para o nRetCode parâmetro.

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 não fatal.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 demonstrativo.Isso indica um erro de programação.Não há informações adicionais estão disponível de SQLError.
SQL_STILL_EXECUTING	Uma função que foi iniciada assincronamente ainda está em execução.Observe que, por padrão, a MFC nunca irá passar esse valor para CheckRowsetErrorMFC continuará chamada SQLExtendedFetch até que ela retorna não mais SQL_STILL_EXECUTING.

Para obter mais informações sobre o SQLError, see the Windows SDK. Para obter mais informações sobre buscar a linha em massa, consulte o artigo conjunto de registros: Buscando os registros em massa (ODBC).