This function downloads a file from the FTP Server. You can specify a Full Path, a Relative Path, or a File Name in the Current Remote Directory. To work with the Current Remote Directory, use the FTPit_ChangeRemoteDir function first.

By default, this function will wait until the download is completed before returning control to FileMaker. To make this function download a file in the background, use the CompletedScript parameter to specify a script to call once the download is complete. The script that is called would either call the FTPit_Disconnect function or perform other operations.

If you call this function while the plug-in is uploading or downloading a separate file in the background, the new file will be added to a "queue" of files to be downloaded. When the current file has completed uploading or downloading, the new file will begin to download. You can use the FTPit_GetQueueList function to return the current files that will be uploaded or downloaded.

CompletedScript

The Name of a Script to call when the Download is Completed. (If blank, this function will wait until the Download is Complete before returning; Default is blank.)

LocalFile

The Local File to Download the File to. (Can be a Full Path, a Relative Path, or a File Name in the Current Local Directory.) If the file already exists, it will be overwritten. If no file exists with the name, a new file will be created.

AppendToFile

If True and the File Exists, this function will append to the File.

UseASCIIMode

If True, this function will Download the files using ASCII Mode instead of Binary Mode. (Default is False.)

CSParameter

The parameter to send to the completed script.