WebFtpPut Function

Action

Puts random data bytes in a file on the FTP server.

Include file

WebAPI.bdh

Syntax

WebFtpPut( in hFtp            : number, 
           in nBytes          : number, 
           in sRemoteFile     : string, 
           in bBinaryTransfer : boolean): boolean;

Return value

true if successful
false otherwise

Parameter	Description
hFtp	Valid handle to an FTP session
nBytes	Number of bytes to be generated randomly
sRemoteFile	String that contains the name of the file to create on the remote system. Can be either partially or fully qualified file name relative to the current directory. A backslash (\) or forward slash (/) can be used as the directory separator for either name. WebFtpPut translates the directory name separators to the appropriate character before they are used.
bBinaryTransfer	If this parameter is set to true, WebGetFile transfers the file using FTP's Image (Type I) transfer method. The file is transferred exactly as it exists with no changes. This is the default transfer method. If this parameter is set to false, FTP's ASCII (Type A) transfer method is used. Control and formatting information is converted to local equivalents.

Example

// Put random data bytes in a file on the FTP server. 
dcltrans 
  transaction TWebFtpDir 
  var
    hFtp   : number;
    nBytes : number; 
  begin
    WebFtpConnect(hFtp, "standardhost", WEB_PORT_FTP, 
                   "anonymous", "mymail@address.com");
    nBytes := RndUniN(1000..5000); 
    WebFtpPut(hFtp, nBytes, "RndGenTestFile", true);
    WebFtpShutdown(hFtp); 
  end TWebFtpDir;

Sample scripts

WebMulti01.bdf