Syntax

  FTPGet( strRemoteFile, strLocalFile, numTransferType, numOverwrite )  

strRemoteFile

The full path and name of the desired file on the remote server, using the syntax “/file path/file name.extension“. Some FTP servers are case sensitive, so you should always use correct capitalization.

strLocalFile

The full path and name where you want to save the file on the local machine, using the syntax “C:file name.extension“.

numTransferType

A numeric flag that specifies the file transfer type. This parameter is optional; if no value is given, then the transfer type is unknown (0) by default.

0	Unknown
1	ASCII
2	Binary
10	Unknown, without caching
11	ASCII, without caching
12	Binary, without caching

Note: In most cases, you should use option 10. This automatically detects the format (ASCII or Binary) of the remote file and sets the transfer type accordingly, and it also forces the project to download the file from the actual FTP server rather than from an intervening proxy or cache server.

numOverWrite

A numeric value that specifies whether the local file (specified by strLocalFile) may be overwritten if it already exists. This parameter is optional; the default value is 0.

0	Do not overwrite — return an error if the file already exists.
1	Overwrite.

Returned value

Notes

Before you can call this function, you must configure the FTP settings (i.e., server address and login) using the CnfFTP function.

Also, this function is executed asynchronously, so you must call the FTPStatus function to see if the transfer has been completed successfully.

Example