Share this page

# 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.

Tips to improve your search results... VuGen Function Reference Version 25.1-25.3 Function Reference 25.1-25.3 All View Local Help Center View Online Help Center Version: