FUNCTIONUnder review

FTPDirChange

FTPDirChange(cDiretorio) --> lRet

Changes the current remote directory.

FTPDirChangeAdvPL

01 · OVERVIEW

Overview

The path belongs to the remote session rather than the AppServer disk. The official example checks success before listing. Failed changes must stop dependent operations rather than deleting or downloading in the previous directory. 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

FTPDirChange(cDiretorio) --> lRet

Parameters

cDiretorio

CharacterRequired

Allowed remote directory.

Return value

Logical operation success.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed398()
    Local bAction := {|cRemote| FTPDirChange(cRemote)}
    // 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.