FUNCTIONUnder review

FTPDownload

FTPDownload(cArqDest, cArqOrig) --> lRet

Copies a remote file to a local destination.

FTPDownloadAdvPL

01 · OVERVIEW

Overview

Destination comes first and remote source second. The manual places the destination below Protheus RootPath rather than the workstation Downloads folder. Validate name, directory and replacement policy; the source establishes no atomic write guarantee. 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

FTPDownload(cArqDest, cArqOrig) --> lRet

Parameters

cArqDest

CharacterRequired

Destination below RootPath in documented context.

cArqOrig

CharacterRequired

Allowed remote name.

Return value

Logical operation success.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed401()
    Local bAction := {|cTarget,cSource| FTPDownload(cTarget,cSource)}
    // 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.