TCUnlink

 

Descrição

Encerra a conexão especificada com o DBAccess

Sintaxe

TCUnlink( <nConn> )

 

Parâmetros

ParNomeTipoDescriçãoDefaultObgRef
01nConnNuméricoIndica o número da conexão que será finalizada. Caso esse parâmetro não seja especificado, a conexão ativa/atual será finalizadaX

Retorno

RetornoTipoDescrição
lRetBooleanRetorna 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

Exemplo

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
#INCLUDE "TOTVS.CH"
 
 
User Function TCUnlink()
Local nRet		:= 0
Local cMsg		:= ''
 
 
If ( nRet := TCLink( 'MSSQL/UAUA', '127.0.0.1', 7890 ) ) < 0
cMsg += 'Conexão (MSSQL/UAUA): Erro ' + Str( nRet, 4 )
Else
TcUnlink( nRet )
Endif
 
If ( nRet := TCLink( 'MSSQL/UNIVERSOADVPL', '127.0.0.1', 7890 ) ) < 0
cMsg += 'Conexão (MSSQL/UNIVERSOADVPL): Erro ' + Str( nRet, 4 )
Else
TcUnlink( nRet )
Endif
 
 
MsgInfo( cMsg, 'UniversoADVPL' )
 
 
Return( Nil )

Resultado

TCUnlink - Resultado

TCUnlink – Resultado

Informação Adicional

 

Informações Adicionais

 

  • 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, porém vão gerar mensagens de advertência no log de console do Application Server.

 

 

0 respostas

Deixe uma resposta

Want to join the discussion?
Feel free to contribute!

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *