Função: TCUnlink
Encerra a conexão especificada com o DBAccess.
TCUnlink ( [ nHndConn] , [ lQuiet ]) --> lRet
Nome | Tipo | Descrição | Obrigatório | Referência |
nHndConn | Numérico | Indica o número da conexão que será finalizada. Caso esse parâmetro não seja especificado, a conexão ativa/atual será finalizada. | N | N |
lVerbose | Lógico | Caso especificado .T., mostra mensagens de advertência do log de console, como por exemplo fechamento automático de alias da conexão. (**) Disponível apenas a partir da Build 7.00.131227A, vide observações. | N | N |
lRet
- (logico)
- Retorna verdadeiro (.T.), se a conexão for encerrada com sucesso; caso contrário, falso (.F.), se houver falha de execução. Geralmente, as falhas de execução ocorrem quando tentamos encerrar uma conexão informando um handler inexistente ou já fechada anteriormente.
- Se o parâmetro <nHndConn> não for informado, a conexão atualmente ativa será encerrada.
- Em um ambiente com mais de uma conexão simultânea realizada via TCLink(), duas ou mais conexões estão ativas, o fechamento de uma automaticamente coloca a conexão anteriormente aberta como ativa.
- O número da conexão é obtido no momento que a conexão é estabelecida, através da função TCLink().
- Ao executar a função TCUnlink(), não deve mais haver tabelas abertas utilizando a conexão que está sendo fechada. Caso existam, elas serão fechadas automaticamente.
- Caso uma conexão seja encerrada através da função TCUnlink(), caso algum Alias de tabelas e/ou querie aberto na conexão em questão ainda estivesse aberto, era emitida uma mensagem de advertência no log de console do APPServer, informando que houve o fechamento automático do(s) alias relacionados a conexão. A partir do release 7.00.131227A com data de geração igual ou superior a 10/02/2016, estas mensagens de advertência deixaram de ser registradas no log de console, sendo possível habilitá-las novamente apenas mediante a utilização do parâmetro lVerbose, que passa a ser considerado a partir deste release.
_nCon1 := TCLink('MSSQL7/TOPSQL1', 'TOPSERVER1')
_nCon2 := TCLink('MSSQL7/TOPSQL2', 'TOPSERVER2')
......
TCUNLINK(_nCon1) // Finaliza a conexão _nCon1
Advanced Protheus ( Todas as Versões )
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas