ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Communication / FTP functions
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
FTPConfigure (Function)
In french: FTPParamètre
Warning
From version 28, FTPParameter is kept for backward compatibility. This function has been replaced with FTPConfigure.
Modifies the behavior of standard FTP functions.
Example
// Activation de l'implémentation native du FTP
FTPConfigure(ftpConfigureMode, 1)
// Activation de l'implémentation Windows ("wininet") du FTP
FTPConfigure(ftpConfigureMode, 0)
Syntax
FTPConfigure(<Option> , <Option value>)
<Option>: Integer constant
Option to define:
ftpConfigureModeSelects the FTP operating mode.
  • If <Option value> is set to 0, the FTP functions use the Windows "wininet" module, except for secure protocols (FTPIS, FTPES and SFTP). This mode corresponds to the default operating mode of FTP functions.
  • If <Option value> is set to 1, the FTP functions use a native, Windows-independent implementation of FTP, with UTF-8 support.
    Caution: In this mode, the FTPCommand function is not supported.. This mode is systematically used for the secure protocols (FTPIS, FTPES and SFTP).
ftpConfigureReuseConnectionForces the use of the same FTP server connection between two requests.
  • If <Option value> is set to 0, the client/application opens a connection each time it sends a command, then closes it immediately.
  • If <Option value> is set to 1 (default), the client/application opens a connection when it sends the first command, and keeps this connection open as long as the server and client are exchanging data. After a given period of inactivity, the connection is automatically closed. This connection will be automatically reopened when the next command is executed, with no user action required.
ftpesConfigureSecureModeChanges FTPES encryption.
  • If <Option value> is set to 0, the encryption is applied to FTP data and commands. This is the default mode for functions in FTPES.
  • If <Option value> is set to 1, the SSL encryption is applied only to FTP commands. This mode may be required for some FTPES servers.
In previous versions, this constant corresponds to "ftpesParameterSecureMode".
<Option value>: Integer
New value of the option.
Remarks
The FTPxxx functions of WLanguage use by default the FTP functions of the Windows API (WININET.DLL). In Windows 8.1, these APIs do no longer return the expected results:
  • transfer not completed,
  • "unable to modify the directory to.".
While waiting for the standard FTP functions to be restored by Windows Update, the behavior of WLanguage FTPxxx functions can be modified so that they are no longer based on the FTP functions of Windows API. To do so, insert the following call in the FTP transfer process, before the existing call to FTPConnect:
FTPConfigure(ftpConfigureMode, 1)
Note: FTPConfigure applies to all FTPxxx functions in WLanguage, except FTPCommand.. If this one was used, it can be replaced with FTPSend or FTPGet according to the case.
Business / UI classification: Business Logic
Component: wd30com.dll
Minimum version required
  • Version 19
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/21/2024

Send a report | Local help