version 6.7
FTP_ChangeDir (ftp_ID; directory) Integer
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;"/")
See Also
FTP_GetDirList, FTP_GetFileInfo, FTP_PrintDir.