FTP Vuser Functions (FTP) > Alphabetical List of Functions > ftp_logon_ex

ftp_logon_ex

Example: ftp_logon_ex FTP Vuser Functions (FTP)

Logs onto an FTP server for a specific session.

int ftp_logon_ex( FTP *ppftp, char *transaction, char *url, [attributes,] LAST );

Function objFTP.logon_ex( ppftp as FTP, transaction as String, url as String, ByVal attributes As Variant, LAST ) as Integer    ` for VB Script

ppftp An FTP session identifier.
transaction A transaction name for this step. To instruct VuGen not to create a transaction for this step, use a NULL string, "". To instruct VuGen not to create a transaction for this step, use a NULL string, "".
URL  The URL of the FTP server: "URL=ftp path" The ftp path should have the following format: ftp[s]://[username:[password]@][server[:port]]The use of ftps protocol indicates that the control connection is protected by SSL. However, even if the protocol is ftp, the control connection may be still SSL protected by using AUTH TLS (or similar) attributes
attributes An optional comma-separated list. The following attributes are supported:"LocalAddr=<local_ip:port> A local address for IP spoofing.
"LocalAddressIndex=<number> The index of the local address for IP spoofing.
"ClientCert=<path> The path to the client certificate pem file.
"ClientKey=<path to private key pem file.
"ClientPassword=<password> For the private key.
"ClientCiphers=<c1[:c2][...<:cN]> A colon-delimited list of the client ciphers.
"CertificateAuthority=<directory> The directory containing the certificates of authority.
"AUTH TLS" Activates SSL on the control connection.
"AUTH TLS-C" Activates SSL on the control connection.
"AUTH SSL" Activates SSL on the control connection.
LAST A marker indicating the end of the argument list.

The ftp_logon_ex function logs onto an FTP server for a specific session.

This function is for use with multiple sessions. For global or single sessions, use the ftp_logon function, which leaves out the session identifier.

Return Values

If this function succeeds, it returns LR_PASS. Otherwise, it returns LR_FAIL.

Parameterization

All string input arguments can be passed using standard parameterization.