Árvore de páginas

Permite que um arquivo hospedado em um servidor SFTP remoto possa ser renomeado ou até transferido de uma pasta para outra.

Sintaxe

tSFTPClient():Move( < cOldName >, < cNewName > )

Parâmetros

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

NomeTipoDescriçãoObrigatórioReferência
cOldNamecaractereCaminho e nome do arquivo no servidor SFTP remoto que será movido ou renomeado.X
cNewNamecaractereNovo nome e/ou caminho de diretório que será assumido pelo arquivo no servidor SFTP.X

Retorno

Conforme a tabela abaixo esta função retornará os seguintes valores numéricos. Além disso, o console.log conterá informações importantes adicionais caso for detectados erros.

RetornoTipoDescrição
nRetnuméricoStatus da tentativa de mover ou renomear arquivo no servidor SFTP.

Exemplo

user function sftp_rename_file()

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

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

  //eliminar previamente os arquivos existentes
  oSftp1:RemoveFile("TLPPrename.txt")
  oSftp1:RemoveFile("renamedTLPP.txt")

  //criar novos arquivos
  nRet2 := oSftp1:MakeFile("TLPPrename.txt")
  if (nRet2 <> 0)
    ConOut("Falha em criar um arquivo para testes no servidor SFTP")
    return .F.
  endif

  nRet3 := oSftp1:Move("TLPPrename.txt", "renamedTLPP.txt")
  if (nRet3 <> 0)
    ConOut("Falha em renomear o arquivo")
    return .F.
  endif

return .T.

Lista de códigos de erros e seus respectivos significados

CódigoSímboloDescrição
0SFTP_MOVEFILE_OKOperação executada com sucesso
-10SFTP_MOVEFILE_FAILFalha em mover ou renomear o arquivo
  • Sem rótulos