Command FTP_ChangeDir

4D Internet Commands

FTP_ChangeDir

version 6.7


FTP_ChangeDir (ftp_ID; directory) Integer

ParameterTypeDescription
ftp_IDLongintReference to a FTP login
directoryTextUnix 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;"/") 

See Also

FTP_GetDirList, FTP_GetFileInfo, FTP_PrintDir.