For information about Globalscape, visit www.globalscape.com.

Transferring from URLs Asynchronously (TransferURLAsync)

• Use the TransferURLAsync method to start a download from a web address, and return control to the script immediately. This method does not wait for the transfer to end. You can use it to perform many simultaneous transfers.

• The difference between this method and DownloadAsync is simply the ability to specify all of the necessary parameters in one command, rather than having to set the user name, port, host, etc. and then transfer a file.

• Immediately after you call this method subsequent methods in your script will be called, so be careful when timing certain events.

• If TransferURLAsync encounters a problem when trying to complete its task, it will not throw a COM, ATL, or VB error. TransferURLAsync will also adhere to your max global and per site settings. You can't use wildcards in this method.

Syntax

Object.TransferURLAsync(BSTR bstrURL [, long nMultipartNumber])

Parameters

Example

Set MySite = CreateObject("CuteFTPPro.TEConnection")

MySite.TransferURLAsync "ftp://ftp.cuteftp.com/pub/cuteftp/english"

'this will transfer the entire English CuteFTP directory from the CuteFTP.com ftp site.

Normal Formats Supported

ftp://user:pass@ ftp.sitename.com:port

ftp://user:pass@ ftp.sitename.com

ftp://user@ ftp.sitename.com

ftp:// ftp.sitename.com:port

ftp:// ftp.sitename.com

ftp://ftp.sitename.com/pub l: user p: pass ß l: user is a lowercase "L", not "one"

ftp://ftp.sitename.com/pub:44 l: user p: pass

ftp://ftp.sitename.com/pub port:44 l: user p: pass

ftp://ftp.sitename.com/pub l/p: user/pass

ftp://ftp.sitename.com/pub:44 l/p: user/pass

ftp://ftp.sitename.com/pub p:44 l/p: user/pass

ftp://ftp.sitename.com/pub port:44 l/p: user/pass

ftp://ftp.sitename.com/pub l: user p: pass

ftp://ftp.sitename.com/pub:44 l: user p: pass

ftp://ftp.sitename.com/pub p:44 l: user p: pass

ftp://ftp.sitename.com/pub port:44 l: user p: pass

Extended URL Formats

Aside from the standard URL formats shown above, additional specifiers may be used to denote the direction of transfer and download path. Use the extended format to perform site to site transfers, uploads, targeted downloads, and more.

The standard url ftp://user:pass@ftp.host.com will be used in the following examples:

• Format: Normal URL transfer

MySite.TransferURLAsync "ftp://user:pass@ftp.host.com"

'download site to the default download folder

• Format: URL [space] "-->" [space] LPATH

MySite.TransferURLAsync "ftp://user:pass@ftp.host.com --> c:\temp"

'download site to the c:\temp folder

• Format: URL [space] "<--" [space] LPATH

MySite.TransferURLAsync "ftp://user:pass@ftp.host.com <-- c:\web"

'upload files from c:\web to the site

• Format: URL1 [space] "<->" [space] URL2

MySite.TransferURLAsync "ftp://user:pass@ftp.host.com <->

ftp://user2:pass2@ftp.host2.com" 'perform a site to site transfer

• Format: URL [space] "<==" [space] LPATH

MySite.TransferURLAsync "ftp://user:pass@ftp.host.com <== c:\web"

'synchronize (mirror local) the c:\web folder to the site

• Format: URL [space] "==>" [space] LPATH

MySite.TransferURLAsync "ftp://user:pass@ftp.host.com ==> c:\web"

'synchronize (mirror remote) the site to c:\web

• Format: URL [space] "<=>" [space] LPATH

MySite.TransferURLAsync "ftp://user:pass@ftp.host.com <=> c:\web"

'synchronize both local and remote (mirror both)