FUNCTIONUnder review

FTPDirectory

FTPDirectory(cMascara, [cAtributo]) --> aRet

Lists files or directories in an FTP session.

FTPDirectoryAdvPL

01 · OVERVIEW

Overview

The historical manual associates D with directories and omission with files. An old official example describes D more broadly; a later TOTVS fix specifies directory-only filtering. Check the LIB and do not infer the complete array layout from one used position. 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–3.)

02 · SYNTAX

Syntax

FTPDirectory(cMascara, [cAtributo]) --> aRet

Parameters

cMascara

CharacterRequired

Remote mask.

cAtributo

CharacterOptional

D for directories according to manual/fix; check LIB.

Return value

Listing array.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed399()
    Local bAction := {|cMask| FTPDirectory(cMask)}
    // 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.