PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Managing the progress of the transfer
  • Time-out for transfer
  • Internet browser
  • Rights of users
  • Relative and absolute path
  • AS/400 FTP server
  • Required permissions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
FTPGet (Function)
In French: FTPRécupère
Transfers a file or directory from an FTP (File Transfer Protocol) server to the current computer.
Versions 15 and later
Android This function is now available for the Android applications.
New in version 15
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 18
Android Widget This function is now available in Android Widget mode.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Android Widget This function is now available in Android Widget mode.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
iPhone/iPad This function is now available for the iPhone/iPad applications.
WINDEVWEBDEV - Server codeReports and QueriesAndroidAndroid Widget JavaAjaxUser code (UMC)
// Download the "/Document/File.txt" file found on the FTP server
// in the "D:\Temp" directory on the current computer
ResRetrieve = FTPGet(7, "/Document/File.txt", "D:\Temp")
Windows Mobile
// Download the "/Document/File.txt" file found on the FTP server
// in the "\Temp" directory on the current computer
ResRetrieve = FTPGet(7, "/Document/File.txt", "\Temp")
Syntax
<Result> = FTPGet(<Connection Identifier> , <File/Directory to Retrieve> , <Destination File/Directory> [, <Procedure Name> [, <Transfer Mode>]])
<Result>: Boolean
  • True if the transfer was performed,
  • False otherwise. To find out the error details, use ErrorInfo associated with the errMessage constant.
    Note: The result may be incorrect on some Unix servers: an existing file or directory may not be found.
<Connection Identifier>: Integer
Connection identifier, returned by FTPConnect.
PHP This parameter is a Variant parameter.
<File/Directory to Retrieve>: Character string (with quotes)
Name and full (or relative) path of the file (or directory) to retrieve. This file (or directory) is found on the FTP server. The different path sections are separated by "slashes" ("/").
Caution: the name of the directory is case sensitive. You must use the same case as the one used on the FTP server (uppercase/lowercase characters).
No wildcard character (* or?) can be used. To retrieve several files, use FTPListFile beforehand to get the name of the files to retrieve.
A full path has the following format: "/<DirectoryName>/<FileName>". The tree structure has the following format: "/<DirectoryName>/<FileName>".
A relative path has the following format: "<DirectoryName>/<FileName>". The tree structure has the following format: "/<CurrentServerDirectory>/<DirectoryName>/<FileName>".
If this parameter corresponds to a directory, all the files found in this directory are retrieved. A directory with the same name is created on the current computer at the location specified by <Destination File/Directory>.
If this parameter corresponds to a file:
  • if <Destination File/Directory> is a directory found on the current computer, the file to retrieve is copied to the destination directory.
  • if <Destination File/Directory> is a file found on the current computer, the file to retrieve is copied and renamed.
<Destination File/Directory>: Character string (with quotes)
Name and full (or relative) path of destination file (or directory). A UNC path can be used.
Windows Mobile No relative path or UNC path can be used.
<Procedure Name>: Optional character string (with or without quotes)
Name of WLanguage procedure automatically called to check the transfer progress. This procedure can be a global method of the class (in the following format: <Class Name>::<GlobalMethodName>).
PHP This parameter is not available.
<Transfer Mode>: Optional Integer constant
Transfer mode used:
FTPBinaryMode
(Default value)
ftpBinaryMode
(Default value)
Transfer performed in binary mode. The file is strictly identical between the sending and the receiving.
FTPASCIIModeftpASCIIModeTransfer performed in ASCII mode. This mode is used to transfer data between two different types of operating systems, from UNIX to Windows for example: the transferred file is changed into the ASCII format of destination system.
Remarks
WINDEVWEBDEV - Server codeReports and QueriesAndroidAndroid Widget Windows MobileJavaAjaxUser code (UMC)

Managing the progress of the transfer

FTPGet is a locking function: no other action can be performed until the end of current transfer.
To check the progress of transfer, FTPGet can automatically call the <Procedure Name> procedure at regular time intervals (every 64 KB).
This procedure is declared as follows:
PROCEDURE <Procedure Name>(<Total Size>, <Transferred Size>)
where:
  • <Total Size> is an integer corresponding to the total size of file or directory currently transferred.
  • <Transferred Size> is an integer corresponding to the number of bytes already transferred.
In this procedure, you have the ability to:
  • display a progress bar,
  • find out whether the transfer is completed (<Total Size> = <Transferred Size>).
FTPGet cannot be interrupted as long as all files have not been transferred. To force the interruption of the browse, use the following code line in the <Procedure Name> procedure:
RESULT False
In any other case (to continue the browse), <Procedure Name> MUST return True.
An error is generated if <Procedure Name> returns no value (neither True nor False).

Time-out for transfer

By default, all the FTP functions fail if the FTP server does not respond within 20 seconds. This time-out can be modified by FTPConnect when connecting to the FTP server.
WINDEVWEBDEV - Server codeReports and QueriesWindows MobileAjaxUser code (UMC)

Internet browser

FTPGet requires Internet Explorer version 3 or later.
If a problem occurs, we recommend that you run a test with the browser by directly passing a link such as "ftp://server/...". If a problem occurs with Internet Explorer (with a UNIX server for example), use FTPCommand directly.

Rights of users

Only a user who has read rights on the FTP server can retrieve the files found on an FTP server. In most cases, the read rights are granted to the "anonymous" users.

Relative and absolute path

The notions of relative path and absolute path are very important in an FTP application.
  • A path starting with a slash is considered as being an absolute path: it is the path in relation to the root of the FTP server (parameter specific to the server).
    ex: /ad/user/JULIA
  • A path not starting with a slash is considered as being a relative path, which means a path given in relation to the current directory. This current directory can be returned or modified by FTPCurrentDir.
When connecting to an FTP site, the initial directory (the "home directory" of the user) is not necessarily found at the root of the FTP server. Therefore, we recommend that you use relative paths.

AS/400 FTP server

FTPGet does not operate properly if the FTP server is found on AS/400.
In this case, we recommend that you use FTPCommand with the FTP "RETR" command (see the documentation about the FTP server for more details).
AndroidAndroid Widget

Required permissions

The call to this function modifies the permissions required by the application.
Required permission : INTERNET
This permission allows the applications to open the network sockets.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230com.dll
Windows Mobile wp230com.dll
Java wd230java.jar
Linux wd230com.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment