4D Doc Center : FTP

Home

4D Internet Commands v14

FTP_ChangeDir


FTP_ChangeDir ( ftp_ID ; directory ) -> Function result

Parameter	Type	Description
ftp_ID	Longint	Reference to a FTP login
directory	Text	Unix directory pathname
Function result	Integer	Error Code

Description

The FTP_ChangeDir command changes your current working directory (CWD) to the path given to the directory parameter.

The commands FTP_GetDirList and FTP_GetFileInfo will also change the current working directory. However, executing the FTP_ChangeDir command is faster and needs less parameters.

ftp_ID is the long integer reference to the FTP session established with FTP_Login.

directory is a text value in the format of a HostPath which references an existing FTP directory. An error will be returned if the directory does not exist or if you do not have sufficient access priveleges to perform this action. In this case, the current working directory will be left unchanged.

Example

This statement will set the CWD to the FTP root:

$err:=FTP_ChangeDir(ftp_ID;"/")