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


Example: ftp_get_ex FTP Vuser Functions (FTP)

Gets a file from an FTP server for a specific session.

int ftp_get_ex( FTP *ppftp, char *transaction, <item list>, LAST );

Function objFTP.get_ex( ppftp as FTP, transaction as String, item_list as String, 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, "".

A list of all the items for this function. Enclose all entries with quotes. Specify either SOURCE_PATH or MSOURCE_PATH.

SOURCE_PATH - The full FTP server path of the file to retrieve.

MSOURCE_PATH - The full FTP server path of the files to retrieve, using wildcards to specify multiple files. If no wildcards are used, all files in the MSOURCE_PATH are fetched.
Wildcard behavior is determined by the FTP server software. If the argument contains wildcards, make sure you test your script on each FTP version you are going to run tests on.

TARGET_PATH - (optional) The path and filename in which to store the retrieved file. If you omit this item, the file will not be stored.

PASSIVE - (optional) Sets the communication protocol to Passive Mode FTP. To enable, pass "PASSIVE=TRUE".

MODE - (optional) Retrieval mode ASCII or BINARY (default).

ENDITEM - Marks the end of the item list. (no quotes)

LAST A marker indicating the end of the argument list.

The ftp_get_ex function gets the working directory on the FTP server for the specified session.

This function is for use with multiple sessions. For global sessions, use the ftp_get function, which does not take a session identifier argument.

Return Values

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


The values of keyword-value pairs can be parameterized. For example, "ALT={altParam}".