Árvore de páginas

Estabelece uma conexão com um servidor SFTP ( SSH File Transfer Protocol ) utilizando o modo de autenticação por usuário e senha.

Sintaxe

TSFTPClient():Connect( < cServer >, < cPort >, < cUser >, < cPassword > )

Parâmetros

Os parâmetros que esta função recebe são descritos abaixo:

NomeTipoDescriçãoObrigatórioReferência
cServercaractereEndereço do servidor SFTP a ser conectadoX
cPortcaractereNúmero da porta do servidor SFTPX
cUsercaractereLogin do usuárioX
cPasswordcaractereSenha do usuárioX

Retorno

Conforme a tabela abaixo, esta função retonará um valor numérico. Além disso, no arquivo console.log serão registradas informações adicionais importantes caso forem detectados erros.

RetornoTipoDescrição
nRetnuméricoStatus de conexão ao servidor SFTP

Exemplo

user function sftp_open_close_connection()

  local nRet1, nRet2
  local oSftp1 = tSFTPClient():new()

  nRet1 := oSftp1:Connect("server1.exemplo.local.br","2222","josevitor","Fs74!@bz*@54/")
  if (nRet1 <> 0)
    conOut("Falha em conectar ao servidor SFTP")
    return .F.
  endif

  nRet2 := oSftp1:Disconnect()
  if (nRet2 <> 0)
    conOut("Falha em desconectar ao servidor SFTP")
    return .F.
  endif

Return .T.

Lista de códigos de erros e seus respectivos significados

CódigoSímboloDescrição
0SFTP_OKSucesso de conexão ao servidor SFTP
-1SFTP_HOST_NOT_FOUNDServidor remoto não encontrado
-2SFTP_SOCKET_FAILFalha no socket da conexão
-3SFTP_CONNECTION_FAILFalha ao conectar no servidor remoto
-4SFTP_SESSION_INIT_FAILFalha ao inicializar o socket
-5SFTP_HANDSHAKE_FAILFalha no HandShake da camada SSH
-6SFTP_SFTP_INIT_FAILFalha ao inicializar o subsistema de SFTP
-28SFTP_KNOWNHOSTS_READ_FAILFalha ao realizar leitura do host
-30SFTP_KNOWNHOSTS_FINGERPRINT_FAILFalha ao realizar leitura da assinatura
-31SFTP_KNOWNHOSTS_MISMATCHAssinatura não-conforme no arquivo de KNOWNHOSTS
-32SFTP_KNOWNHOSTS_NOTFOUNDAssinatura não-encontrada no arquivo de KNOWNHOSTS
-33SFTP_KNOWNHOSTS_CHECK_FAILUREFalha ao verificar o arquivo de KNOWNHOSTS
  • Sem rótulos