FTPPutFile (ImageKit Control/FileIO Method)

This method transfers a file to the FTP server. (It includes connecting to and disconnecting from the server.)

[C++Builder] [ bool = ]imagekitcontrolname->FileIO->FTPPutFile(const UnicodeString ServerName, const UnicodeString ProxyName, short PortNo, bool PassiveMode, const UnicodeString RemoteFilePath, const UnicodeString UserName, const UnicodeString Password, int TransPercent)

[Delphi] [ Boolean = ]imagekitcontrolname.FileIO.FTPPutFile(const ServerName: string; const ProxyName: string; PortNo: Smallint; PassiveMode: Boolean; const RemoteFilePath: string; const UserName: string; const Password: string; TransPercent: Integer)

Parameters

Name	Explanation
ServerName	The name of the FTP server or IPAddress
ProxyName	The Proxy Server IP Address
PortNo	Port Number (default is 21)
PassiveMode	Enables passive mode connectivity: False(0) = Active Mode Connection; True(nonzero) = Passive Mode Connection
RemoteFilePath	The destination on the FTP server where the file is to be saved. Includes path and file name
UserName	The username needed to access the FTP server
Password	The password needed to access the FTP server
TransPercent	The percentage of the file that is tranferred before the ImageKit Progress event is generated

Return Value

Returns True if successful. Returns False if unsuccessful.

Explanation

The FTPPutFile method transfers a file to the FTP server. (It includes connecting to and disconnecting from the server.) This method can only be executed from the client computer. It does not operate on the server. The TransPercent parameter sets the amount of transfer in percentage before the ImageKit Progress event fires. For example, if the TransPercent = 10, the ImageKit Progress event will fire 10 times, 1 time for each 10% of file transferred.

The file to be transferred is specified by the FileName property.

When not using a proxy server set the ProxyName to an empty string.