Histórico da Página

TCSQLError ( ) --> cRet

cRet(caracter)
• Retorna uma string contendo a última mensagem e/ou ocorrênca de erro da conexão atual do DBAccess, registrada após o último statement executado. Caso o último statement executado não apresente erro, ou ainda o processo atual não possua nenhuma conexão ativa com o DBAccess, a função retornará uma string vazia ("").

A string contendo a ocorrência de erro é retornada à aplicação AdvPL com as mesmas informações básicas da ocorrência registrada no log de ocorrências de erro do DBAccess, e é muito útil para determinarmos a causa de falha de diversas operações, que em caso de falha, não causam a queda da aplicação AdvPL.

Por exemplo, uma execução direta de statement através da função TCSQLExec(), em caso de falha no DBAccess e/ou ocorrência de erro no SGBD, não vai gerar uma ocorrência de erro AdvPL, apenas fará a função TCSQLExec() retornar um número negativo. Para obter mais detalhes sobre o que ocorreu, após verificar o retorno da função, constatando que houve falha de processamento, chame a função TCSQLError() para recuperar os detalhes e descrição da última ocorrência, vide exemplo.

nRet = TCSQLEXEC("INSERT INTO MYTABLE(NAME) VALUES('JOHN DOE')")If nRet == 0  MsgInfo('Inserção executada')Else  MsgStop('Falha de Inserção ('+str(nRet,4)+') : '+TcSqlError())EndIf