Função: TCConType (Obsoleto)
Através da função TCConnType() era possível setar o tipo de protocolo utilizado na conexão entre a API Client de acesso do TOPConnect 2 (topapi32.dll) e a aplicação TOPConnect 2.x.
TCConType (Obsoleto) ( < cProtName> ) --> NIL
Nome | Tipo | Descrição | Obrigatório | Referência |
cProtName | Caracter | Indica os valores, sendo: "TCPIP" - para protocolo TCP (Padrão), "APPC" - para protocolo APPC (descontinuado) e "NPIPE" - para protocolo "Named Pipes" (usado apenas em TOPConnect 2.x). | X |
-
NIL(nulo)
- Retorna nulo.
Quando utilizado TOPConnect 2.x, era possível definir um protocolo diferente de TCP/IP para ser utilizado na comunícação da API de acesso do TOPConnect 2.x com o TOPConnect 2.x Server. Por padrão, é utilizado TCP/IP, e ao chamar a função TCConType() antes de estabelecer uma nova conexão de acesso (utilizando a função TCLink), era possível mudar o protocolo a ser utilizado para NPIPE (Named Pipes). Caso informado como parâmetro algum protocolo não listado acima, a aplicação AdvPL é interrompida com uma ocorrência de erro fatal AdvPL "Undefined type <X> - DB connection (ConType) - Valid Values: APPC, TCPIP and NPIPE.".
Esta função é obsoleta e utilizada exclusivamente para TOPConnect 2.0. Foi mantida nas builds mais recentes do Application Server por compatibilidade e caso utilizada para estabelecer conexão com TOPConnect 4.0 e posteriores (DBAccess), sua chamada é desconsiderada. As APIs de acesso do TOPConnect 4.0 e superiores, DBAccess utilizam conexão TCP/IP, sem permitir utilização de outro protocolo, ignorando qualquer chamada da função TCConType().
User Function MyLink()Local cConnT := "NPIPE"Local nHTcConnType(cConnT) // Seta uso de Named PypesnH := TCLink("MSSQL/STRESS_TESTE","127.0.0.1")If nH < 0 MsgStop("Erro de conexão "+str(nH,4)) ReturnEndifMsgInfo("Conexão estabelecida com sucesso - Handler "+str(nH,4))TcUnlink(nH)Return