CRecordset::CheckRowsetError

Artigo
06/10/2015

Chamado para manipular erros gerados durante a busca do registro.

virtual void CheckRowsetError( 
   RETCODE nRetCode  
);

Parâmetros

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

Comentários

Essa função de membro virtual manipula erros que ocorrem quando registros são buscados, e são úteis durante a busca em massa da linha. Você pode querer considerar substituir CheckRowsetError para implementar seu próprio tratamento de erro.

CheckRowsetError é chamado automaticamente em uma operação de navegação do cursor, como Abrir, Requery, ou qualquer operação de Mover . É passado o valor de retorno da função da API SQLExtendedFetchODBC. A tabela a seguir lista os valores possíveis para o parâmetro de nRetCode .

nRetCode	Descrição
SQL_SUCCESS	Função concluída com êxito; quaisquer informações adicionais estão disponíveis.
SQL_SUCCESS_WITH_INFORMATION	A função terminou com êxito, possivelmente com um erro nonfatal. Informações adicionais pode ser obtida chamando SQLError.
SQL_NO_DATA_FOUND	Todas as linhas do conjunto de resultados foram buscadas.
SQL_ERROR	A função falhou. Informações adicionais pode ser obtida chamando SQLError.
SQL_INVALID_HANDLE	A função fracassada devido a uma maçaneta inválida de ambiente, manipular de conexão, ou para o identificador da declaração. Isso indica um erro de programação. Quaisquer informações adicionais está disponível de SQLError.
SQL_STILL_EXECUTING	Uma função que é iniciada de forma assíncrona ainda está sendo executado. Observe que por padrão, MFC nunca passar este valor a CheckRowsetError; O MFC continuará a chamar SQLExtendedFetch até que não retorna SQL_STILL_EXECUTING.

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