FUNCTIONUnder review

FTPRenameFile

FTPRenameFile(cArqAtual, cArqNovo) --> lRet

Renames a remote file.

FTPRenameFileAdvPL

01 · OVERVIEW

Overview

The manual places this operation in the current remote directory and describes a logical result. It establishes no safe-overwrite, cross-volume or atomic-publication guarantee. Validate the target name under integration rules separately from connection success. The example prepares an uninvoked callback. The caller must own the test FTP session and its paths; no server or credentials are embedded. (Sources: refs. 1–2.)

02 · SYNTAX

Syntax

FTPRenameFile(cArqAtual, cArqNovo) --> lRet

Parameters

cArqAtual

CharacterRequired

Current remote name.

cArqNovo

CharacterRequired

Allowed new name.

Return value

Logical operation success.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed404()
    Local bAction := {|cOld,cNew| FTPRenameFile(cOld,cNew)}
    // Do not evaluate: caller must prepare session and paths.
Return Nil

Expected result

Prepared block; no FTP operation performed. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES

Validate permissions, return and session ownership. Close the connection opened by this routine on failure paths too. Do not log passwords.
Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.