Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

FTPRenameFile

FTPRenameFile(cArqAtual, cArqNovo) --> lRet

Renomeia um arquivo remoto.

FTPRenameFileAdvPL
01 · VISÃO GERAL

Visão geral

O manual situa a operação no diretório corrente e descreve retorno lógico. Não estabelece substituição segura do destino, movimento entre volumes ou publicação atômica. O nome de destino deve ser validado como parte da regra da integração, separadamente da conexão. O exemplo prepara um callback e não o executa. O chamador deve controlar a sessão FTP de teste e seus caminhos; não há servidor nem credenciais embutidos. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

FTPRenameFile(cArqAtual, cArqNovo) --> lRet

Parâmetros

cArqAtual
CaractereObrigatório

Nome remoto atual.

cArqNovo
CaractereObrigatório

Novo nome permitido.

Retorno

Lógico de sucesso da operação.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed404()
    Local bAcao := {|cAtual,cNovo| FTPRenameFile(cAtual,cNovo)}
    // Nao avaliar: sessao e caminhos devem ser preparados pelo chamador.
Return Nil
Resultado esperado

Bloco preparado; nenhuma operação FTP realizada. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Validar permissões, retorno e propriedade da sessão. Encerrar a conexão que a rotina abriu inclusive nos caminhos de falha. Não registrar senhas.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Exemplo de Funções FTP. TDN; referência de versões históricas. Consulta em 2026-10-26.
  2. Advpl o Manual, versão 1.0, pp. 341–347. Referência histórica; autoria não confirmada. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha